codex-project-export

把 OpenAI Codex 左侧某个项目下的全部主会话导出为一个可分享的 tar.gz 文件。

Codex 实际把会话按日期存放在 ~/.codex/sessions，项目分组来自每条 rollout 里的 cwd。本工具会扫描这些本地记录、还原项目列表，让会话所有者选择一个项目后再打包。

使用

要求 Node.js 20.17 或更高版本。

npx codex-project-export

使用方向键选择项目，按回车确认。工具随后显示会话数和原始大小，再次确认后在当前目录生成：

codex-<项目名>-<时间>.tar.gz

查看项目但不导出：

npx codex-project-export --list

脚本化导出：

npx codex-project-export --project yujian-ai-workbench --output ./handoff.tar.gz --yes

默认同时扫描当前会话和 ~/.codex/archived_sessions。只导出当前会话：

npx codex-project-export --active-only

完整参数见：

npx codex-project-export --help

归档内容

manifest.json
sessions/
  0001-<session-id>.jsonl
  0002-<session-id>.jsonl

manifest.json 记录项目、会话数量、来源、文件大小、SHA-256 和疑似敏感内容类型。接收人解压后，可以把 sessions 目录交给支持 Codex rollout JSONL 的导入工具。

明确不包含

• 项目源代码和 Git 仓库
• ~/.codex/config.toml
• ~/.codex/auth.json
• Skills、MCP 配置和其他 Codex 设置
• Codex 子代理 rollout

安全说明

会话正文和工具输出仍可能包含源码、终端输出、客户信息或密钥。工具只做常见密钥格式的风险提示，不会修改原文，也不能保证识别全部敏感数据。导出前必须由会话所有者确认，并只通过可信渠道交给获授权的接收人。

归档没有内置加密。需要跨不可信渠道传输时，应先使用组织批准的加密工具加密。

开发

npm install
npm run check

许可证

MIT