grzegorz-raczek-unit8/claude-quota — explained in plain English
Analysis updated 2026-05-18
See your remaining Claude Code 5-hour and weekly quota at a glance from the menu bar.
Track quota across multiple Claude Code accounts, each with its own bar.
Get a color-coded warning before you hit your usage limit.
| grzegorz-raczek-unit8/claude-quota | 1ove9/antenna-forge | ali-vilab/diffusionopd | |
|---|---|---|---|
| Stars | 64 | 64 | 64 |
| Language | Python | Python | Python |
| Setup difficulty | easy | hard | hard |
| Complexity | 2/5 | 5/5 | 5/5 |
| Audience | developer | researcher | researcher |
Figures from each repo's GitHub metadata at analysis time.
Relies on an undocumented internal usage endpoint, so a future Claude Code update could break it.
claude-quota is a macOS menu bar plugin that shows how much of your Claude Code subscription quota you have used. Claude Code (Anthropic's AI coding assistant) enforces a 5-hour rolling usage window and a weekly cap, this plugin displays both as small colored bars directly in your menu bar so you can see your remaining capacity at a glance without opening the Claude Code app. Each account you have configured gets its own bar. The bar turns orange when you have used 70% of the 5-hour window and red at 90%. When the window is fully consumed, the bar switches to showing a countdown until it resets. If you hit the harder weekly limit, the bar turns black and counts down to the weekly reset date. Clicking on the plugin drops down a detailed view for every account showing the 5-hour window, the weekly window, per-model quotas where your plan reports them, any extra usage credits, and the reset times. The plugin refreshes every 5 minutes and includes a manual refresh option. It works by reading your existing Claude Code login token from the macOS Keychain (read-only, so it cannot log you out) and querying the same internal usage endpoint that Claude Code itself uses. No passwords are entered into the plugin and no data goes to third-party services. The README notes that this endpoint is undocumented, so a future Claude Code update could require a fix. Installation is a one-line curl command. The install script sets up SwiftBar (the menu bar plugin host it relies on) via Homebrew if you do not already have it, and registers it as a login item so it restarts after a reboot. The plugin automatically detects multiple Claude Code accounts by looking for config directories in your home folder, and each account can be labeled, hidden from the bar, or managed with a simple config file.
A macOS menu bar plugin that shows your Claude Code subscription usage as live colored bars, reading data from your local login token.
Mainly Python. The stack also includes Python, SwiftBar, macOS Keychain.
The README does not state a license.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.