$ cat ~/map/ccompactor.md

CCompactor

把已结束的 pi、Claude Code、Codex 会话蒸馏成可校验的交接产物，TypeScript 实现。

tools✓ 9月13日

事实速查

安装

npm i -g ccompactor（或从 GitHub releases 下载 macOS、Linux、Windows 的独立二进制）

## 速览

独立 TypeScript 命令行工具：读取已结束的 Claude Code、OpenClaude、Codex 与 Pi 转录，生成紧凑、可校验、带出处链的交接产物，任何代理都能据此接续。

## 要点

$读取 Claude Code / OpenClaude、Codex 与 Pi 的转录，为文件、命令、错误与提交构建确定性台账，按模式提取人类的约束性指令，产出每条断言都带可恢复指针的分层产物。
$核心命令：ccompactor list 按时间倒序列出会话，ccompactor find 在 id、项目与人类最初的提问上做模糊搜索，ccompactor extract 构建交接产物，ccompactor expand 还原指针背后的事件，ccompactor verify 复查产物，ccompactor handoff 搭配 --to 让目标代理带着预载的上下文直接启动。
$会话引用形如 claude:last、codex:6f1a2b3c，或直接给转录路径；ccompactor doctor 报告本机有哪些 agent 存储与后端，--tui 打开交互式浏览器。
$README 自述与 sctxx 同一思路、改用 TypeScript 实现，并声明项目不含任何衍生自 Anthropic Claude Code CLI 的代码。
$明确不做的事：不替代运行中代理的 /compact，不改动源转录，也不声称与专有 Claude Code 逐位一致。

## 常见问题

Q CCompactor 和 sctxx 是什么关系？

README 写得很直白——same idea as sctxx, in TypeScript。两者都读取已结束的编码代理转录，并生成可校验的交接产物。

Q 它会改动读到的会话吗？

不会——它不改动源转录；提取写出的是独立产物，ccompactor verify 会复查该产物的 schema，并核对其引文是否仍在转录中。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年9月13日