Ccburn

🔥 ccburn

  Watch your tokens burn — before you get burned.

TUI and CLI for Claude Code usage limits — burn-up charts, compact mode for status bars, JSON for automation.

Features

- Real-time burn-up charts — Visualize session, weekly, and monthly usage with live-updating terminal graphics
- Pace indicators — 🧊 Cool. 🔥 On pace. 🚨 Too hot.
- Multiple output modes — Full TUI, compact single-line for status bars, or JSON for scripting
- Statusline integration — ccburn collect pipes into your Claude Code statusline for zero-API-call data
- Multi-profile support — Isolated data per Claude Code profile via CLAUDE_CONFIG_DIR
- Automatic data persistence — SQLite-backed history for trend analysis
- Shareable history — ccburn history --json prints that history for other tools, such as the ccburn-mod chart inside Claude Code
- Agent-friendly — ccburn describe outputs structured JSON for AI agents to auto-configure
- Zoom views — Focus on recent activity with --since / --until

Installation

Run claude and login first to refresh credentials.

WinGet (Windows)

npx

npm

pip

From Source

Quick Start

Let Claude Code do the setup for you. Paste this in:
Run npx -y ccburn describe and configure ccburn for me using the output.

ccburn describe emits structured JSON with your exact settings.json path, the before/after statusline snippet, multi-profile notes, and the full command reference — everything Claude Code needs to wire up ccburn collect without you reading the rest of this README.

Prefer manual setup? See Manual Setup below.

Why ccburn collect?

ccburn needs usage data, and its default sources are unreliable:

- OAuth API — frequently returns 429 rate limits
- Claude Desktop cookies — only work for the default profile

ccburn collect solves this by reading the…