Athena setup v9.9.3
Run the bundled installer. It evaluates Claude Code (CC) and Codex (CX) independently.
The repository distribution pair is vibeCoding/claude/9.9.3/.claude and
vibeCoding/codex/9.9.3/.codex.
# From the Rlues repository root: inspect first, then install.
python3 vibeCoding/codex/9.9.3/.codex/skills/athena-setup/scripts/setup-athena.py \
--repo-root "$PWD" --dry-run
python3 vibeCoding/codex/9.9.3/.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).
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.3, and CX skill entries no
longer point at ~/.codex/skills.
python3 vibeCoding/codex/9.9.3/.codex/skills/athena-setup/tests/test_setup_991.py
1---2name: athena-setup-63description: Fresh-install Athena v9.9.3 globally, install a missing Claude Code or Codex endpoint, or verify an existing v9.9.3 installation. Use for first-time global setup; route older installations to athena-migrate instead of overwriting them.4---56# Athena setup v9.9.378Run the bundled installer. It evaluates Claude Code (CC) and Codex (CX) independently.9The repository distribution pair is `vibeCoding/claude/9.9.3/.claude` and10`vibeCoding/codex/9.9.3/.codex`.1112```bash13# From the Rlues repository root: inspect first, then install.14python3 vibeCoding/codex/9.9.3/.codex/skills/athena-setup/scripts/setup-athena.py \15 --repo-root "$PWD" --dry-run16python3 vibeCoding/codex/9.9.3/.codex/skills/athena-setup/scripts/setup-athena.py \17 --repo-root "$PWD"18```1920Use `--only cc` or `--only cx` for one endpoint. Outside the repository, pass21`--cc-package <path-to-.claude>` / `--cx-package <path-to-.codex>`, or set22`ATHENA_CC_PKG` / `ATHENA_CX_PKG`.2324## State policy2526| Endpoint state | Action |27|---|---|28| `fresh` | Preflight every managed destination, then install selected missing endpoints transactionally |29| `CC-only` | Install only CX; leave CC untouched |30| `CX-only` | Install only CC; leave CX untouched |31| `same-version` | Verify files, dynamic package counts, version, and CX skill paths; never overwrite |32| `old-version` | Route that endpoint to `/athena-migrate`; another selected fresh endpoint may still install |33| Existing unversioned or invalid config | Refuse to overwrite; require an explicit merge decision |3435The installer reports paths and counts only. It never prints user configuration values.3637## Installed assets3839- CC: `~/.claude/settings.json`, `CLAUDE.md`, status line, rules, hooks, agents, and skills.40- CX: `~/.codex/config.toml`, `hooks.json`, `AGENTS.md`, hooks, agents, and standards.41- CX skills: `~/.agents/skills/<name>/SKILL.md`. Codex keeps `$CODEX_HOME/skills`42 only as deprecated backward compatibility; the user-level standard is43 `$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)).4445Asset counts come from the selected package at runtime. Do not encode release counts in this skill.46For the fresh CX endpoint, the installer collision-checks and atomically installs the packaged47`AGENTS.md`; do not copy it manually against an existing endpoint.4849## Safety boundaries5051- Setup is fresh-only. Never copy a whole release config over an installed config.52- Fresh selected endpoints are staged as one transaction. A config-write or asset-copy failure53 removes every file created by that transaction; exit code `3` is reserved for incomplete cleanup.54- Generated package junk (`__pycache__`, `*.pyc`, `.DS_Store`, and `tmp/`) is excluded from the55 runtime manifest.56- Do not modify provider, MCP, project, desktop, plugin, permission, or unknown user fields.57- Do not delete `~/.codex/skills` or `~/.agents/skills`. Migration may remove only legacy58 `~/.codex/skills/<name>` paths that the old Athena config explicitly registered.59- Do not read, write, or bypass Codex's hook trust store. Hook content changes can require the60 user to review and trust them again in Codex; report that fact after installation.61- Treat a verification mismatch as drift to review, not permission to repair automatically.6263## Verification6465Run the same command again. A same-version run is read-only and exits successfully only when66all packaged assets exist, hashes match, the version marker is `9.9.3`, and CX skill entries no67longer point at `~/.codex/skills`.6869```bash70python3 vibeCoding/codex/9.9.3/.codex/skills/athena-setup/tests/test_setup_991.py71```
wenjunduan