cctx

Claude Code context utility: see what a session costs, cut it where you want, and put a price on the subscription buckets.

Reads the transcripts Claude Code writes under ~/.claude/projects/ and never modifies them in place unless you ask (trim, repair). Every other operation writes a new file.

pip install lykos-cctx

The command is cctx. A <session> argument is a session-id prefix, an agent id, a title fragment, or a path to a .jsonl.

Sessions

Cost

Costs are API-equivalent dollars from a built-in price table and ITE, input-token-equivalents, a model-agnostic unit (cache write 1.25×, cache read 0.10×, output 5× an input token).

What it knows about the format

docs/FORMAT.md is a measured reference for the transcript format: the linked-list structure, the four kinds of user record, how usage is restated across a call's records, subagent transcripts, wake-up records, and what the transcripts do not contain. Everything in it was verified against real files and says so.

Development

pip install -e . pytest
pytest -q

Releases are tags: push vX.Y.Z and CI tests, builds, publishes to PyPI and creates the GitHub release. The version comes from the tag.