AGENT ReplaY — render a Claude Code session log into a styled terminal view.
See PRODUCT.md for scope and design rationale.
Status: in development. Not yet released.
macOS (Homebrew cask):
brew install eitanpo/tap/agentry
Linux: go install github.com/eitanpo/agentry@latest, or download a binary from the releases.
Available once the first release is tagged.
Run agentry from the directory you ran Claude Code in:
agentry # the most recent session (by time) in this directory's project
agentry <uuid> # a specific session, by full id
agentry view <uuid> # same as above; view is the explicit render verb
agentry finds the session by mapping the current directory to its Claude project folder under ~/.claude/projects/. The first token is a verb (view, list) when it names one, otherwise a session id — they can't collide, since ids are hex and verbs are words. Flags may go before or after operands, and a mistyped verb, flag, or value is met with a "did you mean" suggestion rather than full help.
To find a session, list them:
agentry list # the 10 most recent sessions in this project
agentry list --limit 25 # the 25 most recent
agentry list --since today # everything from today
agentry list --since 7d # the last 7 days
agentry list --since 2026-06-01 --until 2026-06-03
agentry list --include prompts # list each session's prompts beneath its row
Sessions print oldest-to-newest, so the most recent is at the bottom, next to your prompt. Each row shows the start time, duration, turn count, a title (Claude Code's own ai-title summary, falling back to the first prompt, skipping a leading /clear), and the full id — copy an id and pass it to agentry <id> to render that session.
| Flag | Mode | Default | Description |
|---|---|---|---|
--level minimal|standard|detailed|full |
render | minimal |
How much of each turn to show. |
--[no-]thinking|tools|subagents|metrics |
render | — | Override a single channel on top of --level. |
--limit N |
list |
10 |
Cap to N most-recent (0 = no cap; lifted when a time filter is set). |
--since WHEN, --until WHEN |
list |
— | Filter by last-activity time. WHEN: today/yesterday, Nh/Nd/Nw, or YYYY-MM-DD. |
--include CHANNELS |
list |
— | Add per-session detail. Comma-separated; channels: prompts (or all). |
--no-color |
global | — | Disable color (also honors the NO_COLOR env var). |
--help, --version |
global | — | Per-verb --help lists only that mode's flags. |
"render" flags apply to the bare command and view; "list" flags apply to agentry list; "global" flags work anywhere.
JSON output, markdown-file export, content search, and an interactive browser are planned — see the roadmap in PRODUCT.md.
Go + Charm (Glamour, Lip Gloss). Released via GoReleaser to a Homebrew tap. Build, test, and install workflow: DEVELOPMENT.md.
MIT — see LICENSE.