v0.6.0 — npm + Windows + macOS

All your tokens All your rate limits One view

TokenBBQ reads the usage data Claude Code, Codex, Gemini CLI, OpenCode, Amp and Pi-Agent already store on your machine — and shows your tokens, live rate-limit windows, and cost in one dashboard. Zero config, zero cloud.

npx tokenbbq@latest
Download for Windows Download for macOS

First launch: right-click → Open on Mac, "More info → Run anyway" on Windows. We're not signed yet — it's open source, the code's right there.

Zero config Runs locally Live rate limits MIT license No API keys
Claude Code Codex Gemini OpenCode Amp Pi-Agent

Every token. Every model. Every trend.

Your AI coding history, parsed locally and aggregated into one browser dashboard. The live rate-limit side lives in the desktop pill below.

TokenBBQ dashboard showing token usage, costs, top models and an activity heatmap across all six AI coding tools

  • Six tools, one dashboard

    Claude Code, Codex, Gemini CLI, OpenCode, Amp and Pi-Agent — all parsed from local files, aggregated into one view.

  • Every breakdown that matters

    Daily timeline by provider. Cost-by-source donut. Top models ranking. Monthly trend. 90-day activity heatmap. Filter and drill into details by day.

  • Local-only, no API keys

    Reads files your AI tools already write to disk. Nothing leaves your machine. No signup, no telemetry, no cloud.

Live limits, always visible.

A floating pill that pins your live Claude + Codex rate-limit windows and today's token use to the top of your screen. The historical side lives in the dashboard above. One click switches between them.

TokenBBQ desktop pill in dual mode showing Claude rate limits (67% in 5h window, 1% in 7d window) and Codex rate limits (0% in 5h window, 42% in 7d window) plus today's 787k tokens

Live · dual mode · always on top

  • Claude — live from claude.ai

    Polls every 60 seconds. 5-hour and 7-day window utilisation, plus reset countdowns. Session key lives in your OS keyring.

  • Codex — local, plan-aware

    Reads weekly + 5-hour windows from ~/.codex/sessions. Recognises plus / pro / team / enterprise / edu plans.

  • Color-tier warnings

    Green under 50 %. Orange 50 – 80 %. Red over 80 %. Across both Claude and Codex.

  • Source toggle

    Claude only. Codex only. Both stacked. Or neither. The pill remembers your choice across restarts.

Download for Windows Download for macOS
All releases on GitHub →

macOS & Windows builds are unsigned (it's open source — sign it yourself if you want). First launch: right-click → Open on Mac, "More info" → "Run anyway" on Windows.

Linux user? The CLI runs everywhere. The widget Linux build isn't packaged yet — clone the repo and run npm run widget:build if you want to try it now.

Three steps from zero to insight

No config files, no accounts, no setup. Your AI tools already write the data — TokenBBQ just reads it.

Run one command

No install needed. npx pulls the latest version and runs immediately. No env vars, no setup.

$ npx tokenbbq@latest

TokenBBQ scans your tokens

Auto-detects usage logs from six AI coding tools on your machine. Parses them in memory and fetches current model pricing from LiteLLM.

Dashboard opens locally

A localhost dashboard with charts, breakdowns and trends. Or pin the desktop pill and watch your limits live.

localhost:3000
$npx tokenbbq# Open dashboard in browser
$npx tokenbbq daily# Daily token table in terminal
$npx tokenbbq summary# Compact stats overview
$npx tokenbbq scan# Headless: JSON to stdout

Six AI coding tools

Auto-detected if the data exists on your machine. No config required.

Claude Code ~/.claude/projects/**/*.jsonl
OpenAI Codex ~/.codex/sessions/**/*.jsonl
Gemini CLI ~/.gemini/tmp/**/chats/session-*.json
OpenCode ~/.local/share/opencode/ (JSON + SQLite)
Amp ~/.local/share/amp/threads/**/*.json
Pi-Agent ~/.pi/agent/sessions/**/*.jsonl

Local-only. Auditable. No cloud.

Your AI tool logs contain code context, project names and session data. None of it leaves your machine.

  • Your token logs stay on your machine

    Reads files on your filesystem from six AI tools. Aggregates them in memory. Serves a dashboard on localhost. None of it is uploaded.

  • Your claude.ai session, your machine

    The pill reads live Claude rate limits by talking directly to claude.ai with your own session key. It's stored in your OS keyring (Windows Credential Manager / macOS Keychain), never through a TokenBBQ server, because there isn't one.

  • Open source, MIT, auditable

    The entire codebase is on GitHub. Read it, fork it, audit it. Don't trust any tool you can't inspect.

Network requests on first launch: claude.ai (rate limits, only if you connect a session key) · raw.githubusercontent.com (LiteLLM model prices) · cdn.tailwindcss.com + cdn.jsdelivr.net (dashboard styling). That's the entire list.

Frequently asked

Quick answers for the things people search before they install.

How do I track my Claude Code token usage?
Run npx tokenbbq — it auto-finds your local Claude Code session files (no API key, no signup) and shows your token usage and remaining 5-hour and 7-day rate-limit windows. Or grab the desktop pill for the always-visible version.
Is there a ccusage alternative that supports more tools?
Yes. TokenBBQ tracks Claude Code, Codex, Gemini CLI, OpenCode, Amp and Pi-Agent in a single dashboard, plus live rate-limit monitoring across both Anthropic and OpenAI plans. ccusage focuses on Claude Code only.
Can I monitor Claude Code rate limits on Windows?
Yes. The TokenBBQ desktop pill is a native Windows + macOS widget that updates every 60 seconds and warns at 50 % (orange) and 80 % (red) of any window. Most existing widgets are macOS-only.
How do I track Codex CLI usage too?
Already included. TokenBBQ reads ~/.codex/sessions/**/*.jsonl and pulls the weekly + 5-hour rate-limit values straight out of Codex's session log — shown next to your Claude data, with a toggle to switch between them.

Stop guessing. Start grilling.

One command. Six tools. Your data, your machine, your dashboard.

npx tokenbbq@latest

Or grab the desktop pill — Windows & macOS, no Node required.

Star on GitHub ☕ Buy me a token