$ cat ~/map/sctxx.md

sctxx

把已结束的编码代理转录压缩成可校验的交接产物，支持 pi、Claude Code 与 Codex 会话。

tools✓ 9月12日

事实速查

安装

cargo install sctxx（或 npm i -g sctxx 安装预编译二进制）

## 速览

独立命令行工具：读取已结束的编码代理会话转录——pi、Claude Code 与 Codex CLI——生成紧凑、可校验、带出处链的交接产物，供下一个代理作为热启动载入。

## 要点

$直接读取磁盘上的转录，不依赖任何 agent 框架：pi 的 ~/.pi/agent/sessions（会话格式 v1–v3、分支摘要）、Claude Code 的 ~/.claude/projects、Codex CLI 的 ~/.codex/sessions（含 .jsonl.zst 归档）。
$把大转录蒸馏成小交接产物——README 的示范运行把 141,409 个事件、302 MB 的转录在五秒内变成约 3.2k token 的 7.9 KB 交接产物，全程无模型参与。
$核心命令：sctxx extract pi:last --focus ... 构建交接产物，sctxx expand 检视转录区间，sctxx verify .sctxx/ --strict 校验交接产物是否仍然成立，sctxx doctor 探测本机环境。
$摘要后端可选：none 产出无模型、无网络的确定性产物；auto 在有 API key 时优先使用，否则用已装的 agent CLI（含 cli:pi），再退回 none；OpenAI 兼容端点经 SCTXX_BASE_URL 接入。
$sctxx skill install 会教你的代理何时使用它，会话交接只需一句「用 sctxx 提取 claude code 的 7c1e8f82 会话并在此继续」。

## 常见问题

Q sctxx 需要 API key 或运行中的模型吗？

不需要——none 后端是确定性的，可离线使用；模型只在折叠超长会话时用到，CLI 后端 cli:pi 还能复用已有的 pi 登录。

Q 它能读哪些代理的会话？

开箱即用支持 pi、Claude Code 与 Codex CLI；接入其他提供方只需为规范中间表示写一个适配器。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年9月12日