ClaudeChecker sits quietly in your menubar and tracks your Claude API quota usage across both the 5-hour and 7-day windows — so you always know how much runway you have left before hitting a rate limit.
No API key required. It reads directly from your claude.ai session using a built-in browser login — the same data the Claude web app uses.
 Main window |
 Settings |
 Update available |
 Release notes |
 Update notification |
 Limit reset |
 80% limit warning |
 95% limit warning |
Menubar display
- Real-time quota tracking for both 5-hour and 7-day windows
- Circular gauge with percentage, time remaining, and reset time for each window
- Extra usage credits display (monthly limit vs used, with colour-coded progress bar)
- Usage level badge — Low / Med / High — at a glance
- Compact percentage display directly in the menubar:
◔ 22% 35% - Toggle between percentage view and icon-only in Settings
- Auto-updates after every refresh cycle
- Configurable refresh interval: 1 / 2 / 3 / 4 / 5 / 10 minutes
- Update check runs alongside every data refresh
- Persists your chosen interval across restarts
- Built-in login via
WKWebView— sign into claude.ai once, session persists - No API key, no credentials stored beyond the macOS WKWebsiteDataStore
- Re-authenticate any time from Settings → Sign in again
- Limit warnings — floating panel appears near the menubar icon when a window hits 80% (orange) or 95% (red)
- Limit reset — notified when a quota window resets and usage drops back to low
- Update available — notified when a new version is detected
- Post-update confirmation — compact toast confirms the new version on first launch
- All notifications auto-dismiss after 8 seconds, or can be closed manually
- Automatic update detection — checks for new versions on launch and on each refresh cycle
- One-click install: downloads, unpacks, replaces, and relaunches automatically
- Beta channel — opt in to early access builds via Settings toggle
- Sparkline chart showing quota burn history over the session
- Average burn rate calculated from the 5-hour window
- Authentication management
- Menubar display toggle
- Refresh interval picker
- Beta channel toggle
- About section with version, build info, and update check
- Right-click the menubar icon for quick Show and Quit options
- ✕ button hides the panel (app stays running in menubar)
- Full quit via right-click → Quit
- macOS 13 Ventura or later
- A claude.ai account
brew tap superdooper86/tap
brew install --cask claudechecker- Go to Releases
- Download
ClaudeChecker.zipfrom the latest release - Unzip and drag
ClaudeChecker.appto/Applications - Open from Applications — it will appear in your menubar
macOS security prompt? If macOS blocks the app on first launch, run this in Terminal:
xattr -cr /Applications/ClaudeChecker.appThis is not needed when installing via Homebrew.
- Click the menubar icon (gauge symbol)
- If prompted — click Sign In and log into claude.ai in the built-in browser
- Your usage data will appear within a few seconds
ClaudeChecker reads from the following claude.ai API endpoints (authenticated via your session):
| Endpoint | Used for |
|---|---|
/api/bootstrap |
Organisation UUID and account email |
/api/organizations/{id}/usage |
5-hour and 7-day quota windows |
/api/organizations/{id}/overage_spend_limit |
Extra usage spent and monthly limit |
/api/organizations/{id}/prepaid/credits |
Current credit balance |
- No data leaves your machine except to
claude.ai(your own session) andraw.githubusercontent.com(version check) - Session stored in macOS
WKWebsiteDataStore.default()— same as Safari - No analytics, no tracking, no ads
superdooper86 & claude
ClaudeChecker is not affiliated with or endorsed by Anthropic.