# ClaudeChecker **A native macOS menubar app for monitoring your Claude AI usage limits in real time.** [![macOS](https://img.shields.io/badge/macOS-13.0+-000000?style=flat&logo=apple&logoColor=white)](https://www.apple.com/macos/) [![Swift](https://img.shields.io/badge/Swift-5.9-F05138?style=flat&logo=swift&logoColor=white)](https://swift.org) [![Version](https://img.shields.io/badge/version-1.0.0-orange?style=flat)](https://github.com/superdooper86/claudechecker/releases) [![License](https://img.shields.io/badge/license-MIT-blue?style=flat)](LICENSE)

--- ## 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}	_{System notification}
_{80% limit warning}	_{95% limit warning}
_{Limit reset}

**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 - Xcode 15+ (to build from source) - A claude.ai account --- ## Installation ### Download (recommended) 1. Go to [Releases](https://github.com/superdooper86/claudechecker/releases) 2. Download `ClaudeChecker.zip` from the latest release 3. Unzip and drag `ClaudeChecker.app` to `/Applications` 4. Open from Applications — it will appear in your menubar ### Build from source ```bash git clone https://github.com/superdooper86/claudechecker.git open ClaudeChecker/ClaudeChecker.xcodeproj ``` Then in Xcode: set your Team under Signing & Capabilities, then **⌘R** to run. --- ## First Run 1. Click the menubar icon (gauge symbol) 2. If prompted — click **Sign In** and log into claude.ai in the built-in browser 3. 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) and `raw.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.}