claude-usage

Claude Code Usage Dashboard

Pro and Max subscribers get a progress bar. This gives you the full picture.

Claude Code writes detailed usage logs locally — token counts, models, sessions, projects — regardless of your plan. This dashboard reads those logs and turns them into charts and cost estimates. Works on API, Pro, and Max plans.

Available as a web app (python cli.py dashboard) and as a VS Code extension.

Created by: The Product Compass Newsletter

What this tracks

Works on API, Pro, and Max plans — Claude Code writes local usage logs regardless of subscription type. This tool reads those logs and gives you visibility that Anthropic's UI doesn't provide.

Captures usage from:
- Claude Code CLI (claude command in terminal)
- VS Code extension (Claude Code sidebar)
- Dispatched Code sessions (sessions routed through Claude Code)

Not captured:
- Cowork sessions — these run server-side and do not write local JSONL transcripts

Requirements

- Python 3.8+
- No third-party packages — uses only the standard library (sqlite3, http.server, json, pathlib)
Anyone running Claude Code already has Python installed.

Quick Start

No pip install, no virtual environment, no build step.

macOS / Linux (Homebrew)
Homebrew has disabled installing a formula from an arbitrary raw URL, so tap the repo first (thanks @adrianlungu for the working incantation in #46).

After install, the claude-usage command is on your PATH and accepts the same subcommands as python cli.py (scan, today, stats, dashboard).

Any OS (uv tool / pipx)

Installs the claude-usage command without a clone (works with pipx too: pipx install git+https://github.com/phuryn/claude-usage). The tool stays dependency-free — this only adds packaging metadata, no third-party runtime deps (#144).

macOS / Linux…