Skip to content
Skills Library
Personal productivity · Automation

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.

Licence
MIT
Last repository change
29.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 29.10.2026, without references to retired models or APIs.

Licence

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

  1. Three user steps
  2. Start or resume
  3. Boundaries and acceptance
Original SKILL.md headings · 33 lines, 549 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.