🔥 TokenBurn

See what your AI coding agents cost you — in tokens and dollars, from the logs already on your disk.

A terminal UI, a desktop GUI and a web dashboard (plus a CLI for scripts), all in Rust, all showing the same live numbers.

Cross-platform: Linux, macOS and Windows are supported.

TokenBurn reads local logs only — no network calls, no account, no telemetry. It understands pi, Zed, Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode and Amp, shows where the tokens (and money) went, and keeps itself up to date while you work.

Choose your front-end

Same data, same charts, same 43 themes — pick whichever fits how you work.

🖥️ Terminal UI — tokenburn-tui

For when you live in the terminal. Browse the report, watch the charts, and filter as you type.

• Report table with a stacked token chart and a share-by-project pie
• Instant filtering: / free text (claude -zed), f per-tool checkboxes with row counts
• Options popup (o): toggle panels, auto-refresh interval (5–300 s or off)
• Theme picker with live preview (T), or [ / ] to cycle

cargo install tokenburn-tui && tokenburn-tui --daily

🪟 Desktop GUI — tokenburn-gui

A native window (Iced) with interactive, animated charts. Click a bar to scope everything to that day, click a slice to scope it to that project.

• Stacked bars over time (tokens or cost) and a project donut; hover for tooltips
• Click to drill down — the table, totals and the other chart follow
• macOS app, Windows installer, and Linux (one binary for X11 and Wayland)
• Drop-down pickers for tool, view, window and theme

cargo install tokenburn-gui && tokenburn-gui

🌐 Web dashboard — tokenburn-web

A local web page in your browser. Live over a WebSocket, drill-down by clicking, and every view is a shareable URL.

• Server-rendered SVG charts with CSS animation — no JavaScript charting library
• Filters are Topcoat signals: changing one updates the page in place
• A drilled-down view is part of the URL: ?sel_bucket=2026-09-22&sel_project=pi%3Aatlas
• JSON API at /api/report; binds to 127.0.0.1 by default

tokenburn-web            # opens http://127.0.0.1:3000

⌨️ CLI — tokenburn

For scripts and pipes.

tokenburn                  # this month, every tool, with a per-tool breakdown
tokenburn --daily --all    # all history, one line per day and tool
tokenburn --tool claude --monthly
tokenburn --currency EUR   # costs in euros (see "Currencies" below)
tokenburn --json           # machine-readable (always US dollars)

What it reads

all (the default) reads every tool that is installed; one that isn't simply contributes nothing. Cost is shown only where the tool logs one — otherwise $0.00 rather than a guess (token counts are exact). Cursor, Windsurf, VS Code Copilot Chat and JetBrains AI keep no usable token log on disk, so they can't be supported.

The Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode and Amp readers follow the formats documented by ccusage and are covered by fixture tests; pi and Zed were also checked against real logs. If one misreads your data, open an issue with a (redacted) log line.

Shared by every front-end

Always up to date. Nothing to press — each front-end re-reads the logs itself, and only re-parses the files that changed, so leaving one open is cheap.

Charts. Tokens or cost over time (one stacked bar per hour, day or month, one colour per tool) and a donut of the biggest projects. In the GUI and web dashboard they animate in, and clicking drills down:

Changing the tool, view or window drops the selection.

Responsive. All three front-ends adapt to the space they get, on the same three breakpoints — wide (≥ 980 px, ≥ 110 terminal columns), medium (≥ 700 px, ≥ 70 columns) and narrow — so a phone-sized browser, a half-screen window and an 80×24 terminal are all comfortable:

The terminal UI follows the terminal size live (it re-lays itself out as you resize):

• TUI: the cache columns go at < 110 columns; below 70 only total and cost stay, the pie and the theme chip make room (the currency stays), and the hints shrink. Charts shrink on short terminals and vanish below 22 rows so the table keeps the space; under 40×10 you get a "terminal too small" notice instead of a garbled screen.
• GUI: try it with TOKENBURN_GUI_SIZE=400x820 tokenburn-gui (the window can be as small as 320×420).
• Web: plain CSS media queries on the same breakpoints; tables scroll sideways instead of overflowing, and the chart text gets larger and sparser when it is scaled down.

43 themes, dark and light — Dracula, Nord, Tokyo Night, Catppuccin, Gruvbox, Solarized, Kanagawa, Rosé Pine, Everforest and more — shared by every front-end, including one colour per tool in the charts. Pick one with --theme "Tokyo Night" (--list-themes lists them), or in the UI; the choice is remembered in settings.json (~/.config/tokenburn/, ~/Library/Application Support/tokenburn/, %APPDATA%\tokenburn\; override with TOKENBURN_CONFIG_DIR), so all front-ends start with the same theme.

Currencies. Every tool logs its cost in US dollars; pick another currency to see it converted — 41 are built in (EUR, GBP, CHF, JPY, RON, RUB, UAH, PLN, CZK, HUF, INR, CNY, BRL, CAD, AUD, AED, and more; --list-currencies prints them all). Choose one with --currency EUR, the pick list in the GUI, the select in the web dashboard (?currency=EUR) or C in the TUI; the choice is remembered in settings.json for every front-end. Amounts keep cents ($0.04), and yen, won, forint and the like have none.

TokenBurn never goes online, so the exchange rates are fixed estimates (marked ≈ next to the cost label). For exact ones, add your own to settings.json — they win over the built-in values and lose the ≈:

{ "currency": "EUR", "rates": { "EUR": 0.91, "RON": 4.55 } }

(rates are units per US dollar). JSON output (--json, /api/report) always stays in dollars.

Install

Prebuilt (GitHub releases)

Every portable archive holds all binaries for that target, the web runtime in assets/ (so tokenburn-web runs live), the README and licence, plus a .sha256.

macOS: the app is ad-hoc signed, not notarised — right-click → Open the first time, or xattr -dr com.apple.quarantine TokenBurn.app.

From crates.io

cargo install tokenburn        # CLI
cargo install tokenburn-tui    # terminal UI
cargo install tokenburn-gui    # desktop GUI
cargo install tokenburn-web    # web dashboard (static mode; see "Live mode" below)

No python3 or zstd binary needed — sqlite and zstd are bundled.

Using it

TUI keys

Filters apply instantly to the rows already loaded; the header shows what is active, e.g. ⌕ filter:"claude" tools:3/8 412/3,029 rows.

Web dashboard

just run-web                        # live dashboard, opens http://127.0.0.1:3000
tokenburn-web --port 8080 --no-open # flags: --host, --port (or HOST / PORT), --no-open, --theme

It binds to 127.0.0.1. --host 0.0.0.0 exposes it on the network — there is no authentication, and token/cost data is private, so only do that deliberately.

Live mode needs Topcoat's browser runtime. Release archives, the DMG, the Windows installer and the .deb/.rpm include it. When building yourself, just run-web bundles it (needs cargo install topcoat-cli), or run topcoat asset bundle and point TOKENBURN_WEB_ASSETS at the result. Without it, tokenburn-web still works and serves a static dashboard (form filters, links instead of clicks, reload every 10 s) — which is what cargo install tokenburn-web gives you. Search order: $TOKENBURN_WEB_ASSETS, <exe dir>/assets, <exe dir>/../share/tokenburn-web/assets, /usr/share/…, /usr/local/share/….

Development

just build              # whole workspace
just run-tui            # run-cli / run-tui / run-gui / run-web
just check-all          # fmt + clippy + tests + nu script tests
just coverage           # line coverage (cargo-llvm-cov)
just --list             # everything else

tokenburn (cli) ──┐
tokenburn-tui ────┼──▶ tokenburn-core ──▶ rusqlite, zstd, serde_json, chrono
tokenburn-gui ────┤
tokenburn-web ────┘

Demo recordings

The GIFs above live in examples/vhs/generated/ and are stored with Git LFS (git lfs install once). They are generated from synthetic data (examples/vhs/fixture.sh), never from real logs:

just vhs-tui         # TUI + CLI tapes (examples/vhs/*.tape) — needs vhs, ttyd, ffmpeg
just screenshots     # GUI (macOS) + web screenshots and GIFs — needs ffmpeg, node, a Chromium browser
just vhs-tape filter # one tape (narrow / medium: the responsive terminal demos)

License

MIT — see LICENSE.