claude-code-transcripts-ingest-0.1.1 is not a library.
claude-code-transcripts-ingest
CLI that ingests every Claude Code transcript under ~/.claude/projects into a
DuckDB database, with a normalised schema suited for usage / cost analysis across
sessions, subagents, tool calls, and cache tokens. Ships with an embedded viewer
served over HTTP.
Installs the cct binary.
Install
The duckdb dependency is bundled (built from C++ sources), so the install is
self-contained but takes a minute or two the first time.
Quick start
Commands
cct ingest
cct ingest [-i <dir>] [-o <file>] [-j <jobs>] [--pricing <toml>] [--no-progress]
| Flag | Default | Meaning |
|---|---|---|
-i, --input-dir |
~/.claude/projects |
Directory scanned recursively for .jsonl |
-o, --output |
./transcripts.duckdb |
Output DuckDB file (overwritten each run) |
-j, --jobs |
0 (logical CPUs) |
Parallel worker threads |
--pricing |
— | TOML overriding the seeded model_pricing table |
--no-progress |
— | Silence per-second progress on stderr |
cct serve
cct serve [--db <file>] [--port <n>]
| Flag | Default | Meaning |
|---|---|---|
--db |
./transcripts.duckdb |
DB file to serve |
--port |
8766 |
Listen port |
Run cct --help / cct <subcommand> --help for the authoritative flag list.
Library
The transcript parser lives in claude-code-transcripts
and can be used standalone without DuckDB.
License
Dual-licensed under MIT OR Apache-2.0.