codex-rehome

Codex Rehome

帮助普通用户把 Codex Desktop 的历史对话、索引、skills、plugins、生成物和指定项目文件夹迁移到另一台电脑，或在重装系统前备份并在重装后恢复。

支持：

• Mac -> Windows
• Windows -> Mac
• Windows -> Windows
• Mac -> Mac
• 同一台 Windows 电脑重装系统前备份、重装后恢复

第一原则

先判断用户现在处于哪个阶段，再行动。不要一上来丢一串命令。

1. 原电脑：盘点、选择项目与对话、打包、验证 ZIP。
2. 传输中：让用户把 ZIP 私下传到新电脑。
3. 新电脑：安装并登录 Codex、解压、合并恢复、映射路径、注册项目、验证。
4. 重装系统：重装前把 ZIP 放到不会被清空的非系统盘或移动硬盘；重装后按新电脑阶段恢复。

每次先用一句人话告诉用户：现在在哪个阶段、接下来需要做什么。

开始前只确认这些

• 源系统和目标系统是什么。
• 是换电脑、离职交接，还是同机重装系统。
• 哪些项目文件夹需要带走。项目文件夹不会因为复制 Codex 数据而自动包含。
• 是否要重点选择某些对话；不确定时默认迁移全部标准 Codex 数据。
• ZIP 准备通过飞书、网盘、局域网、移动硬盘还是其他私密方式传输。

默认使用 standard 模式。除非用户明确要求并理解风险，不要迁移 auth token、浏览器登录态、Cookies、.env、API key、私钥或其他 secrets。

原电脑：打包

先定位本 Skill 的目录，然后调用其中的脚本。可以让用户选择多个项目和重点对话。

Windows 原电脑

.\scripts\create_windows_codex_migration_package.ps1 `
  -Project "C:\path\to\project-one" `
  -Project "C:\path\to\project-two"

重点对话可以重复添加：

  -SelectedChat "C:\Users\<user>\.codex\sessions\...\rollout-....jsonl"

同机重装 Windows 时，必须指定非系统盘或移动硬盘：

.\scripts\create_windows_codex_migration_package.ps1 `
  -Project "C:\path\to\project" `
  -Out "D:\Codex-Rehome-Backup"

不要把重装备份只放在 Desktop、Downloads、%USERPROFILE% 或任何会随 C: 被清空的位置。

Mac 原电脑

bash ./scripts/create_mac_codex_migration_package.sh \
  --project "/path/to/project-one" \
  --project "/path/to/project-two"

重点对话可以重复添加：

  --selected-chat "$HOME/.codex/sessions/.../rollout-....jsonl"

打包后必须报告

• ZIP 的完整路径和大小。
• 使用的模式。
• 包含了哪些项目。
• sessions、skills、plugin manifests、generated images、SQLite 文件数量。
• manifest、checksum 是否存在并通过。
• 敏感文件排除结果。
• 目标电脑应该运行哪条恢复命令。

传输

ZIP 可能包含私人对话、记忆、日志、生成图片和本地路径，只能私下传输，不要上传到公开 GitHub 仓库或公开帖子。

同机重装系统时，“传输”指把 ZIP、manifest、checksum 和恢复说明保存在重装后仍存在的非系统盘或移动硬盘，并在重装前确认文件真实存在。

新电脑：恢复

先让用户安装并登录 Codex。恢复前关闭 Codex Desktop；需要重新登录属于正常情况。

默认使用 merge restore，不要整体替换目标 .codex。保留目标电脑的 auth.json、config.toml、installation_id、models_cache.json 和 chrome-native-hosts-v2.json。