# Athena Setup

> 全新安装 Athena 9.9.6 或补装缺失端点。用户显式调用时触发；已装旧版改走 athena-migrate。

- Skill: `wenjunduan/athena-setup-7` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add wenjunduan/athena-setup-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wenjunduan/athena-setup-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wenjunduan (https://skillmd.com/u/wenjunduan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wenjunduan/athena-setup-7

---


# Athena setup v9.9.6

Run the bundled installer. It evaluates Claude Code (CC) and Codex (CX) independently.
The repository distribution pair is `vibeCoding/claude/9.9.6/.claude` and
`vibeCoding/codex/9.9.6/.codex`.

```bash
# From the Rlues repository root: inspect first, then install.
python3 vibeCoding/codex/9.9.6/.codex/skills/athena-setup/scripts/setup-athena.py \
  --repo-root "$PWD" --dry-run
python3 vibeCoding/codex/9.9.6/.codex/skills/athena-setup/scripts/setup-athena.py \
  --repo-root "$PWD"
```

Use `--only cc` or `--only cx` for one endpoint. Outside the repository, pass
`--cc-package <path-to-.claude>` / `--cx-package <path-to-.codex>`, or set
`ATHENA_CC_PKG` / `ATHENA_CX_PKG`.

## State policy

| Endpoint state | Action |
|---|---|
| `fresh` | Preflight every managed destination, then install selected missing endpoints transactionally |
| `CC-only` | Install only CX; leave CC untouched |
| `CX-only` | Install only CC; leave CX untouched |
| `same-version` | Verify files, dynamic package counts, version, and CX skill paths; never overwrite |
| `old-version` | Route that endpoint to `/athena-migrate`; another selected fresh endpoint may still install |
| Existing unversioned or invalid config | Refuse to overwrite; require an explicit merge decision |

The installer reports paths and counts only. It never prints user configuration values.

## Installed assets

- CC: `~/.claude/settings.json`, `CLAUDE.md`, status line, rules, hooks, agents, and skills.
- CX: `~/.codex/config.toml`, `hooks.json`, `AGENTS.md`, hooks, agents, and standards.
- CX skills: `~/.agents/skills/<name>/SKILL.md`. Codex keeps `$CODEX_HOME/skills`
  only as deprecated backward compatibility; the user-level standard is
  `$HOME/.agents/skills` ([Codex 0.144.1 loader source](https://github.com/openai/codex/blob/rust-v0.144.1/codex-rs/core-skills/src/loader.rs#L318-L337)).

Asset counts come from the selected package at runtime. Do not encode release counts in this skill.
For the fresh CX endpoint, the installer collision-checks and atomically installs the packaged
`AGENTS.md`; do not copy it manually against an existing endpoint.

## Safety boundaries

- Setup is fresh-only. Never copy a whole release config over an installed config.
- Fresh selected endpoints are staged as one transaction. A config-write or asset-copy failure
  removes every file created by that transaction; exit code `3` is reserved for incomplete cleanup.
- Generated package junk (`__pycache__`, `*.pyc`, `.DS_Store`, and `tmp/`) is excluded from the
  runtime manifest.
- Do not modify provider, MCP, project, desktop, plugin, permission, or unknown user fields.
- Do not delete `~/.codex/skills` or `~/.agents/skills`. Migration may remove only legacy
  `~/.codex/skills/<name>` paths that the old Athena config explicitly registered.
- Do not read, write, or bypass Codex's hook trust store. Hook content changes can require the
  user to review and trust them again in Codex; report that fact after installation.
- Treat a verification mismatch as drift to review, not permission to repair automatically.

## Verification

Run the same command again. A same-version run is read-only and exits successfully only when
all packaged assets exist, hashes match, the version marker is `9.9.6`, and CX skill entries no
longer point at `~/.codex/skills`.

```bash
python3 vibeCoding/codex/9.9.6/.codex/skills/athena-setup/tests/test_setup_991.py
```