Token Tracker
Know exactly what you're spending on AI — across every CLI
Auto-collect token counts from 22 AI coding tools, aggregate them locally, and see real cost trends in a beautiful dashboard. No cloud account, no API keys, no setup — just one command.
⭐ If TokenTracker saves you time, please star it on GitHub — it helps other developers find it.
⚡ Quick Start
Requirements: Node.js 20+ (CLI runs on macOS / Linux / Windows; native desktop app ships for both macOS (menu bar) and Windows (system tray). Cursor token reading uses the system
sqlite3CLI when available and falls back tonode:sqliteon supported Node releases).
npx tokentracker-cli
That's it. First run installs hooks, syncs your data, and opens the dashboard at http://localhost:7680.
What you get in 30 seconds:
- 📊 A local dashboard at
localhost:7680with usage trends, model breakdown, cost analysis - 🔌 Auto-detected hooks for every supported AI tool you have installed
- 🏠 100% local — no account, no API keys, no network calls (except optional leaderboard)
- 🧩 Optional: a Skills tab that browses 250+ public skills and syncs them across Claude · Codex · Grok · Antigravity · Gemini · OpenCode · Hermes
Want a native desktop app?
- macOS — Download
TokenTrackerBar.dmg→ drag to Applications. Menu bar status icon, desktop widgets, and the dashboard in a WKWebView.- Windows — Download
TokenTracker-Setup.exe→ run the per-user installer (no admin needed). System-tray app with the dashboard in WebView2. Portable zip also on the releases page.
Install globally for shorter commands:
npm i -g tokentracker-cli
tokentracker # Open the dashboard
tokentracker sync # Manual sync
tokentracker status # Check hook status
tokentracker status --json # Machine-readable summary (pipe to jq, ingest from AI agents)
tokentracker status --light # Plain ASCII table (CI / SSH, no spinner)
tokentracker doctor # Health check
🍺 Homebrew (macOS)
Prefer brew? Install directly — no extra tap step needed:
# macOS menu bar app (DMG)
brew install --cask mm7894215/tokentracker/tokentracker
# CLI only
brew install mm7894215/tokentracker/tokentracker
Upgrade with brew upgrade --cask mm7894215/tokentracker/tokentracker. The tap auto-bumps within an hour of every new release.
✨ Features
- 🔌 22 AI tools out of the box — Claude Code, Codex CLI, Cursor, Gemini CLI, Antigravity, Kiro, OpenCode, OpenClaw, Every Code, Hermes Agent, GitHub Copilot, Kimi Code, CodeBuddy, Grok Build, oh-my-pi, pi, Craft Agents, Kilo CLI, Kilo Code, Roo Code, Zed Agent, Goose
- 🏠 100% local — Token data never leaves your machine. No account, no API keys.
- 🚀 Zero config — Hooks auto-install on first run. From zero to dashboard in 30 seconds.
- 📊 Beautiful dashboard — Usage trends, cost breakdowns by model, GitHub-style activity heatmap, project attribution
- 🖥️ Native desktop app — macOS menu bar (+ widgets) and Windows system tray, each with an embedded server and the dashboard in a native webview
- 🎨 4 desktop widgets — Pin Usage / Activity Heatmap / Top Models / Usage Limits to your desktop
- 📈 Real-time rate limit tracking — Claude / Codex / Cursor / Gemini / Kiro / Copilot / Antigravity quota windows with reset countdowns
- 💰 Cost engine — 2,200+ models priced via LiteLLM (auto-refreshed daily) + curated overrides for niche tools (Kiro, Cursor Composer, Kimi, CodeBuddy hy3); 24h disk cache + bundled offline snapshot mean accurate USD without an internet connection. Models without published vendor pricing (e.g. Tencent hy3-preview) are tracked by tokens but show $0 cost until the vendor publishes a rate.
- 🌐 Optional leaderboard — Compare with developers worldwide; drag-to-reorder columns to focus on the providers you care about (opt-in, sign in to participate)
- 🧩 Optional Skills tab — browse 250+ public skills from
anthropics/skills,ComposioHQ/awesome-claude-skills,skills.shand any GitHub repo you add; sync them across Claude / Codex / Grok / Antigravity / Gemini / OpenCode / Hermes with named targets and one-click Undo - 🔒 Privacy-first — Only token counts and timestamps. Never prompts, responses, or file contents.
🖼️ Showcase
Dashboard — usage trends, model breakdown, cost analysis
Desktop Widgets — pin usage to your desktop
Menu Bar App — animated Clawd companion + native panels
Global Leaderboard — compare with developers worldwide
Skills Manager — browse 250+ public skills from GitHub & skills.sh, install once, sync to Claude / Codex / Grok / Antigravity / Gemini / OpenCode / Hermes. Per-target toggles, one-click Undo, no manual file copying.
🔌 Supported AI Tools
| Tool | Detection | Method |
|---|---|---|
| Claude Code | ✅ Auto | SessionEnd hook in settings.json |
| Codex CLI | ✅ Auto | TOML notify hook in config.toml |
| Cursor | ✅ Auto | API + SQLite auth token |
| Kiro | ✅ Auto | SQLite + JSONL hybrid |
| Gemini CLI | ✅ Auto | SessionEnd hook |
| OpenCode | ✅ Auto | Plugin system + SQLite |
| OpenClaw | ✅ Auto | Session plugin |
| Every Code | ✅ Auto | TOML notify hook |
| Hermes Agent | ✅ Auto | SQLite sessions table (~/.hermes/state.db) |
| GitHub Copilot | ✅ Auto | OpenTelemetry file exporter (COPILOT_OTEL_FILE_EXPORTER_PATH) |
| Kimi Code | ✅ Auto | Passive wire.jsonl reader (~/.kimi/sessions/**/wire.jsonl) |
| oh-my-pi (Pi Coding Agent) | ✅ Auto | Passive reader (~/.omp/agent/sessions/**/*.jsonl) |
| CodeBuddy (Tencent) | ✅ Auto | SessionEnd hook in ~/.codebuddy/settings.json (Claude-Code fork) |
| Grok Build (xAI) | ✅ Auto | SessionEnd hook + passive updates.jsonl / signals.json scan (~/.grok/sessions/**/) |
| Kilo CLI (kilo.ai) | ✅ Auto | Passive SQLite reader (~/.local/share/kilo/kilo.db, OpenCode-fork schema) |
| Kilo Code (VS Code extension) | ✅ Auto | Passive ui_messages.json reader (Cursor/Code/CodeBuddy/Windsurf globalStorage) |
| Antigravity | ✅ Auto | Passive transcript reader (~/.gemini/{antigravity,antigravity-ide,antigravity-cli}/brain/**/transcript.jsonl) |
| pi (@mariozechner/pi-coding-agent) | ✅ Auto | Passive reader (~/.pi/agent/sessions/**/*.jsonl) |
| Craft Agents | ✅ Auto | Passive session reader (~/.craft-agent + workspace session logs) |
| Roo Code (V