A tiny macOS menu bar app that shows your Claude usage — 5-hour, weekly, and model limits — with live progress bars and reset timers.
- Download for Mac (Apple Silicon)
- Unzip and drag Token Widget into Applications
- Open it — look for the Claude icon in the menu bar (top-right)
Launches at login by default (toggle in the menu if you want that off).
Requires macOS 14+ and a Claude account. Works best if Claude Code is already signed in.
Click the menu bar icon → Sign In…
- If Claude Code is logged in, it usually connects automatically
- Otherwise finish the browser login and copy the code (⌘C) — the app detects it
- Your Claude tokens stay on your Mac only (
~/Library/Application Support/TokenWidget/) - Talks only to Claude / Anthropic — no analytics, no third-party tracking
- Sign Out clears local credentials
| Issue | What to try |
|---|---|
| App won’t open | Right-click → Open, or allow under System Settings → Privacy & Security |
| Not signed in | Use Sign In… again and copy the browser code |
| Numbers look old | Click Refresh Now — if you see · cached, the last fetch was stale or rate-limited |
| Weekly limit hit | The menu-bar strip turns red with a W badge and the weekly countdown until it resets |
| Near the limit (≥90%) | Bar / ring go orange as a heads-up before you’re fully exhausted |
git clone https://github.com/adityarai7297/token-widget.git
cd token-widget
brew install xcodegen
./build.shIf xcodebuild fails because only Command Line Tools are selected, install Xcode (or Xcode beta) — build.sh will pick it up automatically.
Release / notarization notes: docs/NOTARIZE.md · Changes: CHANGELOG.md
Not affiliated with Anthropic. Claude® is a trademark of Anthropic PBC.