grzegorz-raczek-unit8/claude-quota

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.