| name | athena-migrate |
| description | Upgrade an existing Athena installation with backup, targeted config migration, asset synchronization, rollback safety, and post-migration verification. Use for Athena v9.9.0 to v9.9.1 upgrades; never use fresh setup to overwrite an older installation. |
Athena migrate v9.9.1
Current automated path: 9.9.0 → 9.9.1. Every selected endpoint must already be 9.9.0 or
9.9.1; a missing endpoint belongs to /athena-setup. All selected 9.9.0 endpoints share one
backup and rollback transaction, while a selected 9.9.1 endpoint is verification-only.
1. Preflight and backup
- Locate release packages from the repository root:
vibeCoding/claude/9.9.1/.claude and vibeCoding/codex/9.9.1/.codex.
- Parse installed configs without printing them:
- CC marker:
~/.claude/settings.json → env.VIBECODING_ATHENA_VERSION.
- CX marker:
~/.codex/config.toml →
shell_environment_policy.set.VIBECODING_VERSION.
- Refuse unsupported or invalid versions. Do not infer ownership from directory presence alone.
- Create a timestamped backup outside the release package. Back up every managed destination
before replacement; never delete backups automatically.
2. Migrate CX config atomically
Inspect both selected endpoints first, then apply:
MIGRATE=vibeCoding/codex/9.9.1/.codex/skills/athena-migrate/scripts/migrate-9.9.0-to-9.9.1.py
python3 "$MIGRATE" --repo-root "$PWD" --home "" --dry-run
python3 --repo-root --home \
--backup-dir ~/.athena-backups/9.9.1-transaction
