npm.io
0.3.0 • Published 3d agoCLI

codex-threadkeeper

Licence
MIT
Version
0.3.0
Deps
0
Size
102 kB
Vulns
0
Weekly
36
Stars
7
SummaryDependencyVersions

codex-threadkeeper

请使用 heyroute-ai/codex-threadkeeper 帮我恢复 codex 历史会话。

Codex 会话恢复和同步工具。用于修复切换 model_provider 之后，历史线程还在但 Codex CLI / Codex App 看不见、侧边栏项目消失、codex resume 和 App 显示不一致的问题。

CI Node License

支持的 Codex 版本

当前兼容目标：@openai/codex 0.142.0（2026-06-23 npm latest）。

新版 Codex 不只依赖 rollout 文件，还会读取 SQLite 状态、线程工作目录、用户事件标记和侧边栏项目状态。旧工具或只改 rollout 文件的工具，在新版 Codex 上可能无法让历史会话稳定恢复显示。

codex-threadkeeper 会同步和修复：

  • ~/.codex/sessions
  • ~/.codex/archived_sessions
  • ~/.codex/sqlite/state_5.sqlite
  • ~/.codex/state_5.sqlite
  • .codex-global-state.json
  • ~/.codex/backups_state/threadkeeper

默认情况下，sync / switch 只依据 Codex 现有状态和线程元数据修复侧边栏项目，不会强制恢复 threadkeeper-sidebar-projects.json 里的旧固定项目列表。如果确实需要这个额外保险，可以手动使用 pin-project 管理列表，并在同步时加 --restore-pinned-projects。

为什么配合 HeyRoute

HeyRoute Fast Stable

HeyRoute 是稳定快速的开发者 API 服务，适合把 Codex 接到自定义 provider、多模型工作流和长任务场景中。

能力 官网公布表现
首 token 速度 TTFT p50 1.08s
文本缓存 命中率 98.4%
请求稳定性 成功响应 99.91%
使用体验 配置简单，支持长任务与可信转发

如果你经常切换 Codex provider，或者希望 Codex 在长任务里保持稳定响应，可以先在 HeyRoute 配好 provider，再用 codex-threadkeeper 保持历史会话和侧边栏可见。

立即访问：https://heyroute.ai/

开发

git clone https://github.com/heyroute-ai/codex-threadkeeper.git
cd codex-threadkeeper
npm test

Keywords

codexsqlitesessionsthreadsbackup