Skip to content

Anthropometer

The agentic debugger for Claude Code, Codex CLI and Gemini CLI: a token usage, cost and context-window tracker that shows what the tokens ARE — live memory map, per-file…

Install

$pip install amtr-paper

Install command taken from the project's README or registry entry. Always review code before running it.

anthropometer  ·  amtr

The agentic debugger for Claude Code.

amtr attaches to a running agent session and lets you debug it the way you would a process: see the model's context window as a live memory map, step through what fills it and read the actual text, rewind to any turn, price every call, drill into each subagent's own window, and autopsy every compaction. Press R and it compiles a ground-truth PDF report of the whole session.

Works on Claude Code, Codex CLI and Gemini CLI sessions — every view, every key, one instrument (see Providers).

↑ replaying a session turn-by-turn: the context map fills, the composition shifts, the trend climbs.

▶ The autopsy: amtr was built in one 153-hour Claude Code conversation — so we pointed it at its own transcripts. 1,945 turns, 1.02 billion cache-read tokens, 3 compactions, $1,472 at API list price. The instrument dissects its own birth.

 ·  Crates.io downloads  ·  License: MIT  ·  vibe coded  ·  Rust + ratatui TUI · Python engine · terminal-only

On a Mac? amtrino puts this in your menu bar — every live session a breathing dot, no terminal needed.   the amtrino grid, live


AI usage


Why "debugger"

A monitor tells you how much. A debugger lets you look inside and move through time — and that is what these keys are: i INSPECT walks the context window segment by segment and reads back the bytes the model actually holds (⏎); ←/→ REPLAY re-renders every view at any past turn from the engine's own snapshot; ⏎ on an agent re-targets the whole instrument to that subagent's window (backspace returns); c opens a compaction's post-mortem — what was dropped, by category and by file. /context gives you one number. amtr gives you the whole picture, continuously: the context window as a live memory map, file access as a traffic seismograph, cache economics as a per-turn ledger, compactions as forensic events, and subagents as an economics table — every quantity labeled authoritative (read straight from the API usage records) or estimated, never blurred together.

It works on any session — Claude Code interactive or headless (claude -p), and Codex CLI — because every agent already writes a complete transcript. amtr just reads it in real time; new agents are a parser away.

Compared to token usage trackers

If you already run a token usage or cost tracker, amtr is not a replacement — it answers the question those tools stop at.

Similar plugs

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies

Documented system prompts from Anthropic - Claude Fable 5.1, Opus 5.5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro,…

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini…