@childclm/codexx

codexx

codexx 是一个跑在 Codex CLI 外层的跨平台启动器，目标是把这几件事收进一个终端入口里：

• 项目级主线 / 分支会话管理
• 多 provider / apiKey 切换
• 基于 Codex 原生会话的恢复、分叉、删除

它不替代 codex，而是建立在 codex 之上。

特性

• 跨平台：Node.js 实现，目标支持 macOS 与 Windows
• 项目隔离：项目元数据保存在 <project>/.codexx/
• Provider 全局共享：全局配置保存在用户配置目录
• 会话树：支持主线会话、分支会话、父子关系
• 恢复与分叉：底层直接调用 codex resume / codex fork

前置要求

• 已安装 Node.js >=18
• 已安装并可运行 codex

先确认：

node -v
codex --version

安装

本地开发安装

npm install -g .

发布后安装

如果包名可用并已发布到 npm：

npm install -g @childclm/codexx

使用

在具体项目目录中运行：

codexx

常见子命令：

codexx init
codexx list
codexx providers

存储位置

Codex 原生数据

这些数据由 codex 自己维护：

• ~/.codex/sessions/
• ~/.codex/session_index.jsonl
• ~/.codex/history.jsonl

codexx 全局数据

macOS / Linux:

~/.config/codexx/providers.json

Windows:

%APPDATA%/codexx/providers.json

codexx 项目数据

<project>/.codexx/project.json
<project>/.codexx/sessions.json

发布前检查

npm run check
npm run pack:dry
npm run publish:dry

当前状态

截至 2026-07-17：

• 本地 npm publish --dry-run 可通过
• 已切换为 scoped 包名 @childclm/codexx
• 如果要正式发布，建议先执行：

npm view @childclm/codexx name version

首次正式发布 scoped 包时，使用：

npm publish --access public

License

MIT