Grep every Claude Code session you've ever run. The lossless Rust parser reads Claude Code's on-disk JSONL at 169 MB/s; the compiled CLI greps it and renders one line per event, 25 ms cold.
Get started
uvx cc-transcript list
Every session is already on disk under ~/.claude/projects. list finds them newest first, and stats collapses one into a screenful:
Driving with an agent? Paste this:
/plugin marketplace add yasyf/cc-transcript
/plugin install cc-transcript@cc-transcript
The plugin's skill teaches Claude to answer "what did I ask you yesterday" from its own history, funneling through the CLI instead of reading raw JSONL.
No Claude Code? Point any agent at the CLI
Use `uvx cc-transcript` to investigate my Claude Code sessions: `list` finds
transcripts on disk, `stats` summarizes one, `grep` searches content, and `show`
renders one compact line per event. Start by listing my newest sessions and
summarizing the most recent one. Docs: https://yasyf.github.io/cc-transcript/
Use cases
Ask Claude what you asked Claude yesterday
Yesterday's session is a megabyte of JSONL, and pasting it into a chat blows the context window. Render the spine instead:
uvx cc-transcript show --signal --tail 20 ~/.claude/projects/<project>/<session>.jsonl
--signal keeps only the substantive user and assistant turns. One line per event, a few hundred tokens for the whole exchange. With the plugin installed, skip the command and ask Claude directly; its skill runs this funnel for you.
Find the session where you fixed that bug
The fix happened weeks ago, in one of a few hundred transcripts. Search them all:
uvx cc-transcript grep "TranscriptExpiredError" --project cc-transcript
Hits print under their transcript's path, each line carrying its raw event index; feed an index back into show --range to re-read the conversation around the fix. grep searches your newest 50 transcripts by default; --all takes it to every session on disk, and a no-match run exits 1 so it scripts cleanly.
Debug a token blowup from transcript evidence
A session burned through the context window and you want the culprit, not a guess. Rank the evidence:
uvx cc-transcript stats --per-file --project myapp
Each block reports text, thinking, and tool-io bytes plus per-tool call counts; the blowup stands out as an outsized tool io line. Then grep --tool <name> --with-result pins it to the exact calls.
Script it from Python
The CLI's funnel is four commands; your own tooling wants the events themselves. parse turns a path into a Transcript of typed lazy views, with the noise already dropped inside the engine:
from cc_transcript import NOISE_SPEC, discover, parse
transcript = parse(discover()[0], drop=NOISE_SPEC)
print(len(transcript.events), "events after the noise drop")
discover() lists every transcript on disk newest first, stream fans a whole corpus across the parse pool, and resolve finds one session by UUID. parse also reads OpenAI Codex CLI rollouts — hand it a path from ~/.codex/sessions and the same typed events come back. The getting-started guide builds this out to a composed filter and a sentiment score.
JSON output schema
show --json and grep --json emit JSONL, with one object per event. Each event
uses the envelope {i, kind, meta, model, text, blocks, stop_reason, usage};
fields that do not apply to its kind are omitted. Every object in blocks has
a type discriminator such as text, thinking, tool_use, tool_result,
or fallback.
More in the docs
- The Python library turns a transcript into typed lazy views, a composed filter, and a score in a dozen lines.
- Filtering events covers composable clauses, specs, and the ready-made
NOISE_SPEC. - Sentiment scoring buckets conversations and scores them around any inference engine.
- Feedback mining runs detectors, confidence calibration, and LLM verdict passes over your corpus.
- The Rust engine is the implementation — parsing, filtering, scoring, and mining — its correctness pinned by hand-owned literals and golden fixtures.
- Codex rollouts make the parser two-provider: OpenAI Codex CLI sessions lower into the same typed events, with rollout discovery, subagent joins, and per-session lifecycle and token totals.
list --provider codexfinds them from the shell. - API reference documents the complete typed surface, from
TranscriptEventtoSessionActivity.
Read the docs for the full guide. Licensed under PolyForm Noncommercial 1.0.0.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cc_transcript-14.16.0.tar.gz.
File metadata
- Download URL: cc_transcript-14.16.0.tar.gz
- Upload date:
- Size: 12.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f24853e2f4b56524487b39c6fdc33837451384671b67e88e2effb4dcc34c7ec
|
|
| MD5 |
d4ad06723e497edc243bf67145d67db3
|
|
| BLAKE2b-256 |
cf4e978469edc9474dbab2bb81b75f8743d6a532f547a0411d59d3531b2fa340
|
Provenance
The following attestation bundles were made for cc_transcript-14.16.0.tar.gz:
Publisher:
release-pypi.yml on yasyf/cc-transcript
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cc_transcript-14.16.0.tar.gz -
Subject digest:
7f24853e2f4b56524487b39c6fdc33837451384671b67e88e2effb4dcc34c7ec - Sigstore transparency entry: 2683734100
- Sigstore integration time:
-
Permalink:
yasyf/cc-transcript@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Branch / Tag:
refs/tags/v14.16.0 - Owner: https://github.com/yasyf
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 28.0 MB
- Tags: CPython 3.13+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6a9f484fc5dd3948f2b87dfd3a8b215a0aa05f6b5cfdf32cb8414a21a9d47af7
|
|
| MD5 |
e5aabab9cd39cb37c71de7b9d743ffca
|
|
| BLAKE2b-256 |
3c4a4f80078b1570cbbcc1f03f0668648efea38f4e04edd10135053d44ff910f
|
Provenance
The following attestation bundles were made for cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_x86_64.whl:
Publisher:
release-pypi.yml on yasyf/cc-transcript
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_x86_64.whl -
Subject digest:
6a9f484fc5dd3948f2b87dfd3a8b215a0aa05f6b5cfdf32cb8414a21a9d47af7 - Sigstore transparency entry: 2683734131
- Sigstore integration time:
-
Permalink:
yasyf/cc-transcript@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Branch / Tag:
refs/tags/v14.16.0 - Owner: https://github.com/yasyf
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_aarch64.whl.
File metadata
- Download URL: cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_aarch64.whl
- Upload date:
- Size: 27.7 MB
- Tags: CPython 3.13+, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34cfebc8994852a0131a24c57fd1d864b9c197ddee5c8a8c84a7ffb6ccc38b47
|
|
| MD5 |
de1c9dbea46ca4ad03c89d4fe0549289
|
|
| BLAKE2b-256 |
70b58b5df4c6a5359ecb3cd2ea86def4d48c7f80c06780112faa0b316211a56a
|
Provenance
The following attestation bundles were made for cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_aarch64.whl:
Publisher:
release-pypi.yml on yasyf/cc-transcript
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cc_transcript-14.16.0-cp313-abi3-manylinux_2_28_aarch64.whl -
Subject digest:
34cfebc8994852a0131a24c57fd1d864b9c197ddee5c8a8c84a7ffb6ccc38b47 - Sigstore transparency entry: 2683734229
- Sigstore integration time:
-
Permalink:
yasyf/cc-transcript@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Branch / Tag:
refs/tags/v14.16.0 - Owner: https://github.com/yasyf
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cc_transcript-14.16.0-cp313-abi3-macosx_11_0_x86_64.whl.
File metadata
- Download URL: cc_transcript-14.16.0-cp313-abi3-macosx_11_0_x86_64.whl
- Upload date:
- Size: 27.8 MB
- Tags: CPython 3.13+, macOS 11.0+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c2fa0ecbe97207bdce3051e0effebd8c5497aea1e8c26755dd8b80c61089ff4
|
|
| MD5 |
aa0037e867406c041faa8de10ece0a9b
|
|
| BLAKE2b-256 |
7e7670498816b6e5fe41e1bbb675f766692bec5feeccc8ebe1431cbde2e076ef
|
Provenance
The following attestation bundles were made for cc_transcript-14.16.0-cp313-abi3-macosx_11_0_x86_64.whl:
Publisher:
release-pypi.yml on yasyf/cc-transcript
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cc_transcript-14.16.0-cp313-abi3-macosx_11_0_x86_64.whl -
Subject digest:
3c2fa0ecbe97207bdce3051e0effebd8c5497aea1e8c26755dd8b80c61089ff4 - Sigstore transparency entry: 2683734267
- Sigstore integration time:
-
Permalink:
yasyf/cc-transcript@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Branch / Tag:
refs/tags/v14.16.0 - Owner: https://github.com/yasyf
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cc_transcript-14.16.0-cp313-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: cc_transcript-14.16.0-cp313-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 27.6 MB
- Tags: CPython 3.13+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
638da6e4cf3e5e25169484f50cd471a3b968f6467e01eb07136fec4b200d917e
|
|
| MD5 |
b0c83e696ae40003093914867c16f3c9
|
|
| BLAKE2b-256 |
90903bd91f81c73710598460e8fffa500f13a267b1a9cd743cdfd12a936fc707
|
Provenance
The following attestation bundles were made for cc_transcript-14.16.0-cp313-abi3-macosx_11_0_arm64.whl:
Publisher:
release-pypi.yml on yasyf/cc-transcript
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cc_transcript-14.16.0-cp313-abi3-macosx_11_0_arm64.whl -
Subject digest:
638da6e4cf3e5e25169484f50cd471a3b968f6467e01eb07136fec4b200d917e - Sigstore transparency entry: 2683734170
- Sigstore integration time:
-
Permalink:
yasyf/cc-transcript@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Branch / Tag:
refs/tags/v14.16.0 - Owner: https://github.com/yasyf
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-pypi.yml@feb2bf0046aefccfd99d24682d847b6a98af86f1 -
Trigger Event:
push
-
Statement type:
