WhereMyTokens — Windows tray app for real-time Claude Code token monitoring

[jeongwookie]

WhereMyTokens

Windows system tray app that shows Claude Code token usage, costs, and rate limits in real time.

https://github.com/jeongwookie/WhereMyTokens

---

What it does

Sits quietly in the taskbar and surfaces everything you need to know about your Claude Code usage at a glance:

• Live session tracking — detects active Claude Code sessions across Terminal, VS Code, Cursor, Windsurf, etc. with real-time status (active / waiting / idle / compacting)
• Rate limit bars — 5h and 1w usage from the Anthropic API, with progress bars and time-to-reset counters
• Claude Code bridge — registers as a statusLine plugin to receive live rate-limit data from Claude Code via stdin (no polling)
• Context window warnings — per-session compact warnings at 50% / 80% / 95%+ inline in the session list
• Tool usage bars — color bar + top-3 tool breakdown (Bash, Edit, Read…) per session
• Activity heatmaps — 7-day heatmap and 5-month GitHub-style calendar grid
• Model breakdown — per-model token and cost totals
• Alerts — Windows toast notifications at configurable thresholds
• Always-on-top widget — global hotkey to toggle, minimize to tray
• Tray label — show usage %, token count, or cost directly in the taskbar

Why I built it

I kept losing track of how many tokens I was burning across sessions and hitting rate limits unexpectedly. I wanted something passive — always visible in the corner, no browser tabs, no manual refreshing. So I built a tray app that reads Claude Code's local JSONL files directly and supplements with the Anthropic API.

Platform

Windows only (Electron + React). Pre-built portable .exe available — no install needed.

Would love feedback, especially on the bridge integration or any feature requests!