Stop getting rate-limited by surprise. See your Claude, ChatGPT, Cursor, and Copilot usage live in the macOS menu bar.
No Electron. No browser extension. One command to install.
One-line (recommended):
curl -fsSL https://raw.githubusercontent.com/yagcioglutoprak/AIQuotaBar/main/install.sh | bashHomebrew:
brew tap yagcioglutoprak/aiquotabar
brew install --HEAD aiquotabar
aiquotabar &The app launches immediately and auto-detects your Claude, ChatGPT, Cursor, and Copilot sessions from Chrome, Arc, Brave, Edge, Firefox, or Safari — no copy-pasting cookies.
I kept getting cut off mid-session on Claude Pro with zero warning. Claude.ai doesn't show your usage until you hit the wall. Same with ChatGPT, Cursor, and Copilot. So I built a tiny menu bar app that shows them all.
| Menu bar | Meaning |
|---|---|
| 🟢 12% | Session usage is low — you're good |
| 🟡 83% | Approaching the 5-hour limit |
| 🔴 100% | Rate-limited — shows time until reset |
| 🔴 100% · | Session is fine but weekly limit is maxed |
Open the menu for full detail:
CLAUDE
🟢 Current Session
██░░░░░░░░░░░░ 12%
resets in 3h 41m
🟡 All Models
████████████░░ 83%
resets Wed 23:00
🟢 Sonnet Only
███░░░░░░░░░░░ 22%
resets Wed 23:00
CHATGPT
🟢 Codex Tasks
█░░░░░░░░░░░░░ 0%
resets Thu 05:38
GITHUB COPILOT
0 / 300 this month
█░░░░░░░░░░░░░ 0%
CURSOR
🟢 Auto
█░░░░░░░░░░░░░ 0%
resets in 27d
🟢 API
█░░░░░░░░░░░░░ 0%
resets in 27d
Native macOS WidgetKit widget — see your AI usage right on your desktop or in Notification Center.
Small widget: Claude + ChatGPT percentages at a glance, color-coded by brand.
Medium widget: Side-by-side breakdown with session limits, weekly caps, progress bars, and reset times.
The widget syncs automatically with the menu bar app — no extra setup. Data updates every 60 seconds.
# Build the widget (requires Xcode)
cd AIQuotaBarWidget && ./build_widget.sh
# Then: right-click desktop → Edit Widgets → search "AI Quota"The widget is entirely optional — the menu bar app works without it. Requires macOS 14+ and Xcode 15+.
- Zero-setup auth — reads cookies directly from your browser (Chrome, Arc, Brave, Edge, Firefox, Safari)
- Claude + ChatGPT + Cursor + Copilot — tracks Claude.ai session/weekly limits, ChatGPT rate limits, Cursor Auto/API usage, and GitHub Copilot premium requests — all in one place
- Desktop widget — native macOS WidgetKit widget with brand-colored progress bars
- Multi-provider — add OpenAI, MiniMax, GLM (Zhipu) API keys to see spending alongside usage
- Burn rate + ETA — predicts when you'll hit each limit based on your current pace
- Pacing alerts — notifies you when you're on track to hit a limit within 30 minutes
- Auto-refresh on session expiry — silently grabs fresh cookies when your session expires
- macOS notifications — alerts at 80% and 95% usage for Claude, ChatGPT, and Cursor
- Configurable refresh — 1 / 5 / 15 min
- Runs at login — via LaunchAgent, toggle from the menu
- Tiny footprint — single-file Python app, no Electron, no background services beyond the app itself
| AIQuotaBar | Open settings page | Browser extension | |
|---|---|---|---|
| Always visible | ✅ Menu bar + desktop widget | ❌ Manual tab switch | |
| Notifications | ✅ 80% + 95% + pacing alerts | ❌ None | |
| Claude + ChatGPT + Cursor + Copilot | ✅ All in one place | ❌ One at a time | ❌ |
| Desktop widget | ✅ Native WidgetKit | ❌ | ❌ |
| Privacy | ✅ Local only | ✅ | |
| Install | ✅ One command | ✅ Nothing | ❌ Store + permissions |
| No Electron | ✅ Single-file Python | ✅ | ❌ Often Electron |
- macOS 12+
- Python 3.10+
- A paid account for any supported service (Claude, ChatGPT, Cursor, or Copilot)
- Chrome, Arc, Brave, Edge, Firefox, or Safari with an active session
git clone https://github.com/yagcioglutoprak/AIQuotaBar.git
cd AIQuotaBar
pip install -r requirements.txt
python3 claude_bar.pyThe app calls the same private usage API that claude.ai/settings/usage uses. It authenticates using your browser's existing session cookies (read locally — never transmitted anywhere except to claude.ai).
curl_cffi is used to mimic a Chrome TLS fingerprint, which is required to pass Cloudflare's bot protection.
| API field | Displayed as |
|---|---|
five_hour |
Current Session |
seven_day |
All Models (weekly) |
seven_day_sonnet |
Sonnet Only (weekly) |
extra_usage |
Extra Usage toggle |
App doesn't appear in menu bar
tail -50 ~/.claude_bar.logCookies not detected Make sure you're logged into claude.ai in your browser, then click Auto-detect from Browser in the menu.
Session expired / showing ◆ ! The app will try to auto-detect fresh cookies from your browser. If that fails, click Set Session Cookie….
- Homebrew tap (
brew tap yagcioglutoprak/aiquotabar && brew install --HEAD aiquotabar) - Native macOS desktop widget (WidgetKit)
- Cursor IDE usage tracking (Auto + API)
- GitHub Copilot premium request tracking
- Burn rate ETA + pacing alerts
- Linux system tray support
- Windows tray app
- Customizable notification thresholds
- Usage history graph
- Multiple Claude account support
PRs welcome. Open an issue first for large changes. See Manual install for dev setup. Logs: ~/.claude_bar.log.
MIT — see LICENSE.
Not affiliated with or endorsed by Anthropic. Uses undocumented internal APIs that may change without notice.