README
¶
agtlog
agtlog is a terminal UI for coding-agent logs. It lists your local Claude Code and Codex sessions in one place and estimates how much each session would cost at API prices. It reads the log files already on your machine, so you need no proxy, no plugin, and no API key.
Install
With Go 1.26.2 or newer:
go install github.com/motoki317/agtlog/cmd/agtlog@latest
Prebuilt Linux and macOS binaries are on the releases page. With Nix, you can run it without installing:
nix run github:motoki317/agtlog
Usage
agtlog
agtlog finds the standard Claude Code and Codex log folders, shows every top-level session, and updates as new activity arrives. Open a row to inspect its nested subagents. Common options:
--agent claude|codex show only one agent
--claude-dir PATH add a Claude home (repeatable)
--codex-dir PATH add a Codex home (repeatable)
--theme NAME color theme: default, nord, or dracula
--no-watch do not follow new activity
--offline do not fetch fresh prices
--refresh-prices fetch fresh prices now, then start
--version print the version
The directory flags add homes for agtlog only. agtlog still reads each agent's
standard home and appends projects for Claude or sessions for Codex. You can
also set AGTLOG_CLAUDE_DIRS or AGTLOG_CODEX_DIRS to a platform-native path
list. A flag overrides its matching environment variable.
agtlog never writes to your agent logs or config. Its only writes are small caches for sessions and prices, kept under your XDG cache folder.
Machine-readable CLI
The list, show, and search subcommands expose the same local sessions to
scripts and coding agents. They emit JSON by default.
agtlog list --project forge --since 7d
agtlog search 'watcher race' --project forge --since 7d
agtlog show 'claude:0f3a9c21-4d7e-4a1b-9d2c-8e5f7a1b3c4d' --offset 12 --limit 1 --full
Replace the fictional project, ref, and event index with values from list and
search.
Filter searches with a project, directory, time range, or session selector. Scoped searches avoid opening unrelated logs and are the fast path.
Use --format text for terminal-safe tables. Subcommands use cached and embedded
prices without a background network request; --offline states that default
explicitly. Use --refresh-prices to update the price cache before a command.
The complete command and JSON contract is in docs/cli.md.
About cost
Costs are estimates based on public API prices.
A ~ marks a published stand-in price. Codex costs commonly use stand-ins; if
you pay for a ChatGPT plan, your real cost is usually lower.
An ! means one model has no price yet, so the shown total is partial.
Keys
| Screen | Keys | Action |
|---|---|---|
| List | j/k, ↑/↓ |
Move |
| List | g/G |
Jump to top or bottom |
| List | / |
Filter sessions |
| List | s |
Change sort: age, tokens, or cost |
| List | a |
Filter by agent: all, Claude, or Codex |
| List | enter |
Open a session |
| List | r |
Reload sessions |
| Detail | j/k, ↑/↓ |
Move and scroll |
| Detail | g/G |
Jump to top or bottom |
| Detail | space/enter |
Expand or collapse |
| Detail | J/K |
Jump between subagents |
| Detail | esc/h |
Back to the list |
| Both | t |
Change color theme |
| Both | ? |
Show all keys |
| Both | q/Ctrl-C |
Quit |
Development
The Nix flake provides Go 1.26 and the project tools. Commands live in the justfile:
just build
just test
just check
just leakcheck
just test-race
Contributor guidance is in AGENTS.md. Design decisions are in docs/ADR/, and the interface vocabulary is in docs/design.md.
Directories