aiburn 0.3.0

Fast Claude Code + Codex usage and cost, from your local logs.

aiburn

Fast, fully local usage & cost reporting for Claude Code and Codex, in one table. See how much you're burning on your coding agents.

$ aiburn
aiburn · Claude Code + Codex usage

Date        Agent   Models       Input  Output  Cache    Cost
──────────  ──────  ───────────  ─────  ──────  ─────  ──────
2026-07-20  claude  opus-5       2.81K    222K  24.4M  $20.44
            codex   gpt-5.6-sol  64.0K   2.42K   500K   $0.64
2026-07-21  claude  opus-5         127   84.8K  22.3M  $17.27
──────────  ──────  ───────────  ─────  ──────  ─────  ──────
Date        Agent   Models       Input  Output  Cache    Cost
TOTAL                            66.9K    309K  47.2M  $38.35

Claude       $37.71   47.0M tokens
Codex         $0.64   567K tokens
Total        $38.35

Claude and Codex each get their own row so their tokens and cost stay separate. Token counts are compact (K/M/B/T) and costs exact — pass --exact for full counts, or --json for raw integers.

Why aiburn

• Fully local & private — it only reads the log files your agents already write on your machine. No network calls, no account, no config; nothing about your usage ever leaves your computer.
• One command, no install — uvx aiburn on macOS or Linux.
• Both agents, one view — Claude Code and Codex side by side, by day, month, or session.
• Fast at any size — scans gigabytes of history in well under a second, with near-instant startup, so it stays snappy as your logs grow.
• Accurate cost — recomputed from token counts (including cache tiers), and kept close to ccusage's numbers.

Run it

No install needed — uv fetches a prebuilt binary and runs it:

uvx aiburn                 # macOS / Linux, any arch
uvx aiburn monthly

Keep it as a permanent command:

uv tool install aiburn     # then just `aiburn`

Or build from source with a Rust toolchain:

cargo install --git https://github.com/handasontam/aiburn

Usage

aiburn [command] [options]

Commands:
  daily      Per-day usage and cost (default)
  monthly    Per-month usage and cost
  session    Per-session usage and cost

Options:
  --since <YYYY-MM-DD>   Only include usage on/after this date
  --until <YYYY-MM-DD>   Only include usage on/before this date
  --claude               Only Claude Code
  --codex                Only Codex
  --all                  Show every session (session view; default: top 25)
  --exact                Full token counts instead of K/M/B/T
  --json                 Emit JSON instead of a table
  -h, --help             Show this help
  -v, --version          Show version

What it reads

Only your local coding-agent logs — read in place, never sent anywhere:

• Claude Code — ~/.claude/projects (also ~/.config/claude and $CLAUDE_CONFIG_DIR)
• Codex — ~/.codex/sessions and ~/.codex/archived_sessions (or $CODEX_HOME)

Cost accuracy

Costs are recomputed from token counts with a built-in pricing table (from LiteLLM / models.dev), including Claude's 5-minute and 1-hour cache tiers. Claude totals track ccusage within ~0.3%. Codex is approximate (~1–2%): its logs carry no authoritative cost, so standard-tier pricing is assumed.

Two details worth knowing:

• Fast mode costs more per token, so it's priced and shown separately — look for an opus-5-fast row alongside the standard opus-5 one.
• Launch discounts are applied by date. Sonnet 5's introductory rate runs through 2026-08-31; days before that stay priced at the discount once it expires, so your history doesn't silently get more expensive.

Acknowledgements

Inspired by ccusage by @ryoppippi and contributors — a great, broader tool that covers many more agents. aiburn is a smaller reimplementation focused on just Claude Code + Codex. ccusage is MIT licensed.

License

MIT