$ cat ~/map/sctxx.md

sctxx

Turns finished coding-agent transcripts into compact, verified handoff artifacts; reads pi, Claude Code, and Codex sessions.

tools✓ Sep 12

cargo install sctxx (or npm i -g sctxx for a prebuilt binary)

## TL;DR

A standalone CLI that reads finished coding-agent session transcripts — pi, Claude Code, and Codex CLI stores — and writes a compact, verified, provenance-linked handoff artifact another agent can load as a warm start.

## Key points

• $Reads transcripts on disk without any agent harness: pi's ~/.pi/agent/sessions (session format v1-v3, branch summaries), Claude Code's ~/.claude/projects, and Codex CLI's ~/.codex/sessions including .jsonl.zst archives.
• $Distills large transcripts into small handoff artifacts — the README's headline run turns a 302 MB transcript with 141,409 events into a 7.9 KB handoff of about 3.2k tokens in five seconds with no model involved.
• $Core commands: sctxx extract pi:last --focus ... to build a handoff, sctxx expand to inspect a transcript range, sctxx verify .sctxx/ --strict to check a handoff is still true, and sctxx doctor to probe the local machine.
• $Summarization backends are optional: none produces a deterministic artifact with no model and no network, auto picks an API key if present, else an installed agent CLI (cli:pi among them), else none; OpenAI-compatible endpoints work via SCTXX_BASE_URL.
• $sctxx skill install teaches your agents when to reach for it, so a session can hand off with a request like use sctxx to extract session 7c1e8f82 from claude code and continue here.

## FAQ

## References

• README ↗
• Documentation ↗

Last updated: Sep 12, 2026