A macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Antigravity ,and Gemini usage at a glance.
Overview
A macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, OpenCode Go, and more at a glance. - - Monitor Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, Amp, and OpenCode Go quotas in one place - - Toggle individual providers on/off from Settings to customize your monitoring - - View Session, Weekly, and Model-specific usage percentages - - Light, Dark, CLI, Christmas, and imported terminal themes (.itermcolors) - - System theme follows your macOS appearance; Christmas auto-enables during the holiday season - - Color-coded progress bars (green/yellow/red) show quota health - - Get alerted when quota status changes to warning or critical - - Automatically updates quotas at configurable intervals - - Quick access with ⌘D (Dashboard) and ⌘R (Refresh) - macOS 15+ - Swift 6.
README
ClaudeBar
Every AI coding quota in your menu bar.
A macOS menu bar app that shows how much of your AI coding quota is left — Claude, Codex, Gemini, Copilot, Cursor and 15 more — with reset countdowns and a notification before you run out.
Quick Start
brew install --cask claudebar
Or download the signed and notarized DMG from Releases. Requires macOS 15+. Launch it, open Settings → Providers and turn on the tools you use; each provider’s doc says what it needs. Building from source: CONTRIBUTING.md.
Providers
| Provider | Tracks | Setup |
|---|---|---|
| Claude | 5-hour session and weekly limits, model limits (Opus, Sonnet, Fable), Extra Usage | docs |
| Codex | 5-hour and weekly rate limits, credits | docs |
| Gemini | Per-model Code Assist quota (Pro, Flash, Flash Lite) | docs |
| Antigravity | Gemini and Claude pools, 5-hour and weekly | docs |
| Z.ai | GLM Coding Plan 5-hour, weekly, monthly and MCP usage | docs |
| Copilot | Monthly AI credits | docs |
| AWS Bedrock | Today’s spend and tokens per model, optional daily budget | docs |
| Amp Code | Free allowance and credit balance | docs |
| Kimi | 5-hour and weekly limits | docs |
| Kiro | Monthly plan credits and bonus credits | docs |
| Cursor | Included monthly usage, on-demand and team credits | docs |
| MiniMax | Coding Plan requests per model | docs |
| DeepSeek | Account balance (paid and granted) | docs |
| OpenRouter | Credit balance (credits minus usage) | docs |
| Vercel Gateway | AI Gateway credit balance | docs |
| Alibaba | Coding Plan 5-hour, weekly and monthly quota | docs |
| Mistral | Today’s Mistral Vibe spend and tokens | docs |
| OpenCode Go | 5-hour, weekly and monthly windows | docs |
| Oh My Pi | Every rate-limit window omp reports, per upstream account, and daily usage from its session logs |
docs |
| Grok | xAI credit allowance per billing period, per product, plan and prepaid balance | docs |
| Command Code | 5-hour and weekly windows, credit balance | docs |
| Cline | Five-hour, weekly and monthly plan limits | docs |
| Warp | Monthly AI credits and add-on credits | docs |
| Devin | Daily and weekly organization quota, with your browser sign-in | docs |
| Windsurf | Daily and weekly quota, or message and flow-action allowances | docs |
| JetBrains AI | Monthly AI credits from your IDE | docs |
| OpenAI API | Organization spend over the last 30 days, per line item | docs |
| Cloudflare AI | Workers AI neurons against 10k a day, Workers AI and AI Gateway tokens, the Workers Paid overage and the last invoice | docs |
| Your own | Anything a script can print, via ~/.claudebar/extensions/ |
docs |
What It Covers
| Area | What you can do |
|---|---|
| All providers | Every provider’s tightest quota on one page as rings, or every quota as bars, one tap from its own → docs |
| Forecast | Under a quota’s reset countdown, whether that window lasts until it resets at its current pace, or when it runs out → docs |
| Menu bar | Up to three providers as a percentage and reset countdown, or a status icon → docs |
| Multiple Codex accounts | Separate logins, identified by email, with independent quotas |
| Alerts & colors | Healthy, warning, critical and depleted levels, pace-aware colors, custom colors and High Contrast → docs |
| Notch | Quota and live Claude Code sessions in the MacBook notch → docs |
| Touch Bar | Quota gauges on a MacBook Pro Touch Bar → docs |
| Notify! | Quota on your iPhone Lock Screen and Home Screen → docs |
| Webhooks | Your quota and status alerts in Slack or at a URL you own → docs |
| Session hooks | Claude Code Started / Finished notifications → docs |
| Daily usage | Today’s cost and tokens next to yesterday’s → docs |
| Leaderboard | Share daily token totals and see where you rank → docs |
| Themes | Dark, Light, CLI, Christmas, Pop, or your terminal’s .itermcolors → docs |
| Extensions | Add any quota source with a manifest and a script → docs |
| URL schemes | claudebar:// actions for Raycast, Alfred and scripts → docs |
Every doc, one line each: docs index. Something not working: troubleshooting.
More
- Contributing — build, test, and where things go
- Architecture — layers and data flow
- Changelog
Sponsors
Apps that use and support ClaudeBar development:
AppNexus for App Store Connect
Contributors
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
To credit someone, comment on any issue or pull request:
@all-contributors please add @username for code, doc
License
Apache License 2.0. See LICENSE and NOTICE.
The notch view uses matrix-swift, which has its own license: you may use it in an app, but not republish its components as a standalone library.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add tddworks/claudebar