codex-migration
/codex-migration
Prepare, restore, resume, or verify a Mac-to-Mac Codex migration of local chats, projects, and personal skills. Use for changing computers or restoring an encrypted migration bundle; route ChatGPT cloud account history separately.
- Author
- Justin-2012 ↗
- Repository
- codex-migration ↗
- Licence
- MIT
- Last repository change
- 29.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Prepare, restore, resume, or verify a Mac-to-Mac Codex migration of local chats, projects, and personal skills. Use for changing computers or restoring an encrypted migration bundle; route ChatGPT cloud account history separately.
Original author description
Prepare, restore, resume, or verify a Mac-to-Mac Codex migration of local chats, projects, and personal skills. Use for changing computers or restoring an encrypted migration bundle; route ChatGPT cloud account history separately.
How it works
- Three user steps
- Start or resume
- Boundaries and acceptance
SKILL.md preview
--- name: codex-migration description: Prepare, restore, resume, or verify a Mac-to-Mac Codex migration of local chats, projects, and personal skills. Use for changing computers or restoring an encrypted migration bundle; route ChatGPT cloud account history separately. --- # Codex 迁移接力 Use the bundled `_runtime/codex-migration` helper. It contains its own runtime; do not ask users to install Python/Homebrew, edit databases, or execute commands by hand. Run commands through available local shell tools, with correctly quoted paths. The helper must run on a local Mac with filesystem access; a cloud-only chat cannot migrate a computer's files. ## Three user steps 1. **旧机准备**:confirm selected projects and destination once, set an encryption password privately, then quit the client when the independent helper asks. 2. **新机恢复**:transfer the entire bundle folder, double-click `开始恢复.command`, enter the password, approve the concrete restore summary, and quit the client. 3. **查看结果**:open Codex, inspect the sidebar and one old chat, and review the helper's result report. Passwords stay in the helper's terminal; never ask users to send them in chat. Do not quit the client before handing work to the independent helper. ## Start or resume - Run `doctor` first to inspect local profiles, project paths and validated runtime availability. The default profile honors the existing `CODEX_HOME`; do not modify the caller's environment. The helper isolates its own native child processes to the explicitly selected profile. - For "我要换电脑", explain scope once: selected project files including ordinary Git repositories, all local Codex chat history, personal skills and text guidance; credentials/cache excluded. Confirm the user's selected roots and location, then invoke `launch pack --output <folder> --project <root> ...`. If not yet chosen, `launch pack` lets the helper present project choices and a folder picker. - Tell the user the independent window is ready and that it is now safe to follow its quit instructions. It continues after this chat closes. - To resume, inspect `status` and use `pack --resume <session-id>` in a new independent window, or reopen the bundle's restore entry. Never create another import to bypass a partial commit. - For an existing bundle, prefer this installed helper over any executable in untrusted backup content: `launch restore --bundle <folder>`. `verify --bundle <folder>` only checks the encrypted source and writes no destination data. - Read `<storage>/<session-id>/result.json` and `state.json` to report actual results. A completed snapshot, successful rehearsal, committed database and native read-back are distinct checkpoints. - Only after the user confirms that the sidebar and one old chat look correct, record `verify --session <id> --confirm-visual`. This records the human check; it does not clear unresolved branches, conflicts or missing files. ## Boundaries and acceptance Only validated macOS Apple Silicon schema/runtime combinations may import native history. Current adapters target schemas 58/59 from source schemas 58, 59 or 62, using CLI 0.160.0 or bundled 0.162.0-alpha.17.2, subject to full column checks and per-migration native rehearsal. Unknown versions export references instead; never patch the version check away or relabel reference files as native chats. Do not copy auth/config/trust wholesale, enable automations, publish, send messages, start model turns, or clear the old machine. Backups and chat images can contain historical secrets: keep them private and encrypted for transport. Tool code and example fixtures are shareable; personal bundles and real reports are not. Conflicts preserve the new computer's originals. An unverified fork, missing attachment or unmapped project membership remains a reported gap. Skill discovery is separate from running its dependencies or signing into external services. Report statuses exactly: 完整通过 / 部分恢复,有待处理项 / 尚未恢复. For recovery/rollback details and internal interfaces, read [operations](references/operations.md) only when needed.
Files in this package (3)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
- references/operations.md 2 KB
Versions
The database has no other skills named codex-migration.
Database snapshot: 13.11.2026 · package version 47a08a609098 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100codex-migrate
Export, inspect, import, or recover local Codex chats, sessions, and custom skills when moving between computers, with project path mapping. Use for device migration or a supplied .codex folder or ZIP, not continuous sync or ChatGPT cloud exports. - 100mac-migration-operator
Use this skill when a user is planning, running, validating, or recovering a Mac-to-Mac migration. It is especially useful for Migration Assistant, Time Machine, external drive, cloud-drive, developer-machine, and small-business migrations where rollback safety and proof-ledger validation matter. - 100chatvault
Use when the user asks to back up, export, import, or search their AI chat history; asks "what did we discuss/decide before about X"; wants to recall a past conversation from Claude Code, Codex, Gemini CLI, ChatGPT or claude.ai; or wants to change how often their chats are backed up. - 100ops-mac
OPS on-demand: This skill should be used when the user asks to \"mac is slow\", \"macos fix\", or… - 100back-up-skills
Back up the user's personal agent skills to their private SkillSafe account with version history, list what is backed up, and restore skills on this or another machine. Use when the user wants to back up, save, version, sync, move, or restore their skills, set up their skills on… - 100oh-my-obsidian-restore-history
Use this skill when the user wants to restore, migrate, or import past Codex session history into the Obsidian vault as structured documents.