Install

macOS users can brew install:

  brew install agent-ecosystem/tap/agentminutes

For other install options, including npm, PyPI, go install, and prebuilt binaries, refer to Installation.

Convert a transcript

To parse a native transcript into a normalized session record, use the convert command (the harness is auto-detected):

  agentminutes convert ~/.claude/projects/my-project/some-session.jsonl

The default output is one JSON document: session metadata, the ordered events, token totals, and a report accounting for everything that did not become an event.

Find your transcripts

Harnesses write transcripts to global, harness-owned locations. To find the sessions you care about without parsing everything, use the sessions command:

  agentminutes sessions --cwd ~/runs/exp-42 | xargs -n1 agentminutes convert

This scans every supported harness’s default root, reads each transcript’s identity cheaply, and filters by the keys harnesses actually record. See Session Discovery.

Summarize a session

To see a session’s behavior at a glance (tool mix, bytes retrieved, latency, tokens, observed models, final answer), use the stats command:

  agentminutes stats session.jsonl

For the full command reference, refer to CLI.