superdooper86
58b947e515
didFinish only fires for cross-document (full page) navigations. After loading https://claude.ai/login the SPA redirects authenticated users via history.pushState to /new — this changes the URL visually but never fires didFinish, so auth was never detected. KVO on webView.url fires for every URL change including SPA pushState, covering the case where the app routes client-side after the initial page load. Both KVO and didFinish now call the same checkCurrentURL helper so detection is not missed regardless of navigation type.
ClaudeChecker
A native macOS menubar app for monitoring your Claude AI usage limits in real time.
Overview
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.
Screenshots
 Main window |
 Settings |
 Update available |
 Release notes |
 Update notification |
 Limit reset |
 80% limit warning |
 95% limit warning |
Menubar display
Features
📊 Usage Monitoring
- 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
🖥 Menubar Display
- Compact percentage display directly in the menubar:
◔ 22% 35% - Toggle between percentage view and icon-only in Settings
- Auto-updates after every refresh cycle
🔄 Auto Refresh
- Configurable refresh interval: 1 / 2 / 3 / 4 / 5 / 10 minutes
- Update check runs alongside every data refresh
- Persists your chosen interval across restarts
🔐 Authentication
- 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
🔔 Notifications
- 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
🔄 Auto Update
- 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
📋 Session Diary
- Sparkline chart showing quota burn history over the session
- Average burn rate calculated from the 5-hour window
⚙️ Settings
- Authentication management
- Menubar display toggle
- Refresh interval picker
- Beta channel toggle
- About section with version, build info, and update check
🖱 Right-Click Menu
- 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
Requirements
- macOS 13 Ventura or later
- A claude.ai account
Installation
Homebrew (easiest)
brew tap superdooper86/tap
brew install --cask claudechecker
Download
- 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.
First Run
- 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
Data Sources
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 |
Privacy
- 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
Built by
superdooper86 & claude
ClaudeChecker is not affiliated with or endorsed by Anthropic.