Single binary · zero setup

See where your Claude Code tokens go.

tokometer reads Claude Code's own session transcripts and turns them into a live dashboard — real token accounting, full history, and a per-prompt cost breakdown. No telemetry exporter, no env vars, no Prometheus, no Grafana, no Docker.

Install → View source on GitHub $ curl -fsSL tokometer.apps.alileza.me/install.sh | sh
localhost:4318
total tokens
4.84 B
tokens today
175.1 M
cache reads (re-sent context)
97.2%
sessions
22
Tokens by type — cacheRead is context re-sent every turn
cacheRead 4.70 B · 97.2% cacheCreation 117.9 M output 15.8 M input 2.2 M
What you get

The whole picture, with nothing to wire up.

Every assistant message Claude Code writes already carries the API response's real token usage, the model, and a timestamp. tokometer just reads it.

⚡

Zero setup

No OTEL_* env vars, no exporter, no restarting your session. Run the binary and open the dashboard.

◎

Real token accounting

input / cache-read / cache-creation / output come straight from each request's usage — exact, not estimated.

⏱

Full history, retroactively

Every past session counts the moment you run it — not just the ones after you turned something on.

≣

Per-prompt breakdown

Which prompts cost the most and why, with the real prompt text and the tools each one triggered.

◱

Context attribution

Which files and tools fill the window, so you can see what's making every turn expensive.

◔

Live tailing

Tails the transcripts and pushes updates over WebSocket — new activity shows up within a couple of seconds.

How it works

Read the files. Skip the pipeline.

Claude Code writes every session to a JSONL transcript under ~/.claude/projects. tokometer reads all of it once, then tails each file for new lines.

📂
Watch
~/.claude/projects
→
🔢
Parse
message.usage
→
📊
Dashboard
localhost:4318
Install

Three ways in. No Go required.

Prebuilt binaries for macOS and Linux (amd64 + arm64). Then just run tokometer.

# one-line install (macOS / Linux, no Go needed) $ curl -fsSL https://tokometer.apps.alileza.me/install.sh | sh # or Homebrew $ brew install alileza/tap/tokometer # or with Go $ go install github.com/alileza/tokometer@latest # then run it and open the dashboard $ tokometer # → http://localhost:4318
RequirementNotes
Claude Code tokometer reads the transcripts it already writes to ~/.claude/projects. Nothing to enable.
macOS or Linux Prebuilt amd64 and arm64 binaries. Windows: grab the .zip from Releases.
A free port Serves on :4318 by default — override with -addr.