claude-code-transcripts 0.1.1

Typed parser for Claude Code transcript JSONL files (session logs under ~/.claude/projects).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# claude-code-transcripts

[![crates.io](https://img.shields.io/crates/v/claude-code-transcripts.svg)](https://crates.io/crates/claude-code-transcripts)
[![docs.rs](https://img.shields.io/docsrs/claude-code-transcripts)](https://docs.rs/claude-code-transcripts)
[![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue)](#license)

Typed parser for Claude Code transcript JSONL files.

Claude Code writes one JSON object per line into `~/.claude/projects/<slug>/<session>.jsonl`.
This crate exposes strongly-typed `Entry` variants covering every line kind the current
client emits (user, assistant, system, summary, attachments, progress, tool uses, tool
results, usage blocks, cache tokens, etc.), plus a round-trip validator useful for
catching schema drift when Claude Code ships new fields.

## Install

```sh
cargo add claude-code-transcripts
```

## Usage

```rust,ignore
use claude_code_transcripts::types::Entry;

let text = std::fs::read_to_string("session.jsonl")?;
for line in text.lines().filter(|l| !l.is_empty()) {
    let entry: Entry = serde_json::from_str(line)?;
    // match on entry variants …
}
# Ok::<(), Box<dyn std::error::Error>>(())
```

## Round-trip validator

Parse every line of a transcript and diff the re-serialized JSON against the original
to detect unknown fields:

```rust,ignore
let result = claude_code_transcripts::check_transcript(std::path::Path::new("session.jsonl"));
result.print_report();
```

Two examples ship in-tree:

```sh
cargo run --example check_one -- path/to/session.jsonl
cargo run --example check_all                             # scans ~/.claude/projects
```

## License

Dual-licensed under [MIT](LICENSE-MIT) OR [Apache-2.0](LICENSE-APACHE).