Skip to content

Repository files navigation

ClaudeBar

Every AI coding quota in your menu bar.

Build Tests codecov Latest Release Swift 6.2 Platform Homebrew

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.

Dark theme
Dark
Light theme
Light

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
Copilot Monthly AI credits docs
Antigravity Gemini and Claude pools, 5-hour and weekly docs
Cursor Included monthly usage, on-demand and team credits docs
AWS Bedrock Today's spend and tokens per model, optional daily budget docs
Kiro Monthly plan credits and bonus credits docs
Kimi 5-hour and weekly limits docs
DeepSeek Account balance (paid and granted) docs
Mistral Today's Mistral Vibe spend and tokens docs
MiniMax Coding Plan requests per model docs
Alibaba Coding Plan 5-hour, weekly and monthly quota docs
Z.ai GLM Coding Plan 5-hour, weekly, monthly and MCP usage docs
Amp Code Free allowance and credit balance docs
OpenCode Go 5-hour, weekly and monthly windows docs
Oh My Pi Every rate-limit window omp reports, per upstream account docs
Grok xAI credit allowance per billing period, per product docs
Command Code 5-hour and weekly windows, credit balance docs
Vercel Gateway AI Gateway credit balance docs
Your own Anything a script can print, via ~/.claudebar/extensions/ docs

What It Covers

Area What you can do
Menu bar Up to three providers as a percentage and reset countdown, or a status icon → docs
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
Session hooks Claude Code Started / Finished notifications → docs
Daily usage Today's cost and tokens next to yesterday's → docs
Themes Dark, Light, CLI, Christmas, 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

Sponsors

Apps that use and support ClaudeBar development:

AppNexus
AppNexus for App Store Connect

Contributors

Thanks goes to these wonderful people (emoji key):

itshan
itshan

💻 📖 🚧
Avish Jha
Avish Jha

💻
Ramiro
Ramiro

💻
LunarECL
LunarECL

💻
Chandler Anderson
Chandler Anderson

💻
Matt Farmer
Matt Farmer

💻
Alex
Alex

💻
sailesh
sailesh

💻
Billy Smith
Billy Smith

💻
nero
nero

💻
BryanYue
BryanYue

💻
Tony Tang
Tony Tang

💻
Frank Hommers
Frank Hommers

💻
Marcus Quinn
Marcus Quinn

💻
hagiwara takayuki
hagiwara takayuki

💻
jeffscottmtl
jeffscottmtl

💻
Tom
Tom

💻
Jeff Welling
Jeff Welling

💻
Zada5
Zada5

💻
fredericoricco-debug
fredericoricco-debug

💻
Kegan Hollern
Kegan Hollern

💻
Jeff Green
Jeff Green

💻
Benjamin Belaga
Benjamin Belaga

💻
romanvalent
romanvalent

💻
Amogh Akshintala
Amogh Akshintala

💻
Daniel Nakolah
Daniel Nakolah

💻
Mitsi-ag
Mitsi-ag

💻
José Cancino Linares
José Cancino Linares

💻
logancox
logancox

💻
y5mei
y5mei

💻
Hanson Kim
Hanson Kim

💻
Add your contributions

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

MIT

About

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.

Topics

Resources

Contributing

Stars

1.5k stars

Watchers

6 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages