docs
Getting started
TokensLab is a desktop app. It reads Claude Code session logs from disk, prices every turn against Anthropic’s published rate card, and shows spend, models, projects and live sessions. Nothing leaves your machine.
1. Install
Download the installer for your OS from the download page. Files are hosted on Backblaze B2. This beta ships Windows and Linux first; macOS follows this weekend after code signing.
- Windows —
.exeNSIS installer, Windows 10 and 11. If SmartScreen appears, choose More info → Run anyway. - Linux —
.AppImagex64.chmod +xthen run it. - macOS —
.dmgfor Apple Silicon, this weekend.
2. Point it at your logs
The default watch folder is ~/.claude/projects. You can change it in Settings. TokensLab only reads files you already have.
3. Read the dashboard
- Today / all time / burn rate — priced with cache-aware rates, not a single input multiplier.
- Idle sessions — no activity for 30 minutes. They still cost if the tool keeps the context warm.
- Unpriced models — missing from the rate card are reported as unpriced, never as free. The total is a lower bound.
Why the number is smaller than you expect
Claude Code records cache creation and cache reads separately. Cache reads dominate real logs and bill at a tenth of the base input rate. TokensLab keeps all five token classes separate. On 66 MB of local session files the naive total was $15,680.35; the cache-aware total was $3,123.97.