$ cat ~/map/ccompactor.md
CCompactor
Turns finished coding-agent sessions — Pi, Claude Code, Codex — into compact, verified, provenance-linked handoff artifacts, in TypeScript.
tools✓ Sep 13
Facts
- repository
- github.com/ccompactor/ccompactor ↗
- GitHub Stars
- ★ 21
- Forks
- 12
- license
- MIT
- npm / mo
- —
- last push
- Sep 14, 2026
install
npm i -g ccompactor (or standalone binaries from the GitHub releases for macOS, Linux, and Windows)## TL;DR
A standalone TypeScript CLI that reads finished Claude Code, OpenClaude, Codex, and Pi transcripts and writes a compact, verified, provenance-linked handoff artifact another agent can continue from.
## Key points
- $Reads Claude Code / OpenClaude, Codex, and Pi transcripts; builds deterministic ledgers of files, commands, errors and commits; extracts the human's binding instructions by pattern; and produces a layered artifact where every claim carries a recoverable pointer.
- $Core commands: ccompactor list for sessions newest first, ccompactor find for fuzzy search over id, project, and the first thing the human asked, ccompactor extract to build the handoff artifact, ccompactor expand to recover the events behind a pointer, ccompactor verify to re-check an artifact, and ccompactor handoff with --to to launch a target agent with the context preloaded.
- $Session refs look like claude:last or codex:6f1a2b3c, or a path to a transcript; ccompactor doctor reports which agent stores and backends are on the machine, and --tui opens an interactive browser.
- $The README pitches it as the same idea as sctxx, implemented in TypeScript, and states the project contains no code derived from Anthropic's Claude Code CLI.
- $Explicitly out of scope: replacing live /compact inside a running agent, mutating a source transcript, or claiming bit-identical behaviour with proprietary Claude Code.
## FAQ
Q How does CCompactor relate to sctxx?
The README states it plainly — same idea as sctxx, in TypeScript. Both read finished coding-agent transcripts and produce verified handoff artifacts.
Q Does it modify the sessions it reads?
No — it does not mutate a source transcript; extraction writes a separate artifact, and ccompactor verify re-checks that artifact's schema and whether its quotes are in the transcript.
## References
## Related entries
$ sctxx
Turns finished coding-agent transcripts into compact, verified handoff artifacts; reads pi, Claude Code, and Codex sessions.
$ doc-bridge
Cross-runtime docs-to-handoff framework: turns repo docs, ownership maps, and human docs into deterministic AgentHandoff contracts consumable by Cursor, Claude, Copilot, and pi.
$ Pi Chat
Minimal local browser chat for pi: streaming replies, persistent sessions, and in-pi launching via /pi-chat-start.
## Guides
Last updated: Sep 13, 2026