QuotaBox

Your AI coding quotas, always in sight.

QuotaBox lives in the macOS menu bar or your Linux tray and shows how much Claude Code, ChatGPT / Codex and GitHub Copilot usage you have left, when each window resets, and whether you will run out before it does.

Download for macOS Linux

Version 1.0.9 · macOS 26 or later · Apple silicon & Intel · Notarized

QuotaBox popover showing Claude Code 5-hour and 7-day usage with reset countdowns and projections

Three providers, one glance

QuotaBox reads the tokens your CLIs already store, polls each provider's usage endpoint, and normalises everything into "percent used" so the badge, alerts and charts work the same way for all of them.

Menu bar badge

Show any provider's limit as icon and percent, icon only, or a ring. Add a second metric and the time to reset. Monochrome if you like a quiet menu bar.

Projections

A burn-rate model over your recent history tells you "100% in ~35 min" or "ends at ~61%", plus the change over the last hour, for every window.

Alerts

One notification per window when a limit first passes your threshold. Thresholds are per provider, so Copilot at 75% and Claude at 90% is fine.

History & trends

Fourteen days of snapshots, line charts per provider, daily peak bars with limit-hit markers, and CSV export from the detail window.

Desktop widget

A small widget with your primary limit as a ring, or a medium one listing every limit with its countdown. Updates whenever the app refreshes.

Global shortcut

Open the popover from anywhere with a shortcut, launch at login, and pick a refresh interval from 2 to 30 minutes.

Every screen, real data

Captured from a running copy. Numbers are the author's own quotas on a Saturday.

QuotaBox detail window: provider sidebar, gauge cards, 24-hour history chart — Detail window: gauges, projections, and history per provider.

QuotaBox settings: badge metric, style, shortcut, refresh interval, alerts — Settings live inside the popover.

Install in a minute

No account, no configuration. QuotaBox only needs the CLIs you already use to be signed in.

Download the DMG, drag QuotaBox to Applications and open it. The app is notarized by Apple, so Gatekeeper lets it through.

Make sure at least one CLI is signed in: run claude, codex, or sign in to Copilot in your editor.

The badge appears in the menu bar within seconds. Open Settings from the popover to choose what it shows.

On Linux, too

A native GTK 4 / libadwaita tray app for Ubuntu 24.04+, Arch and other desktops: the same limits, projections, alerts and history, plus a quotabox command and a Waybar module for tiling setups.

Arch

From the AUR: yay -S quotabox-bin

Ubuntu / Debian

Download the .deb, then sudo apt install ./quotabox_*.deb

Any distro

Download the AppImage, make it executable and run it. It checks for updates itself.

Version 0.1.0 · x86_64 · On GNOME outside Ubuntu, the tray icon needs the AppIndicator extension

What it reads, and what it never does

Tokens are read from where your CLIs store them and used only to call each provider's own usage endpoint. QuotaBox never stores or forwards them.
Claude Code's Keychain entry is read the same way Claude Code itself reads it, so there is no macOS password prompt.
Usage history stays on your computer (Application Support on macOS, ~/.local/share on Linux). There is no QuotaBox server and no analytics.
Updates are delivered through Sparkle from this site, signed with an EdDSA key and verified before install.

Provider	Token source
Claude Code	`CLAUDE_CODE_OAUTH_TOKEN` → Keychain `Claude Code-credentials` → `~/.claude/.credentials.json`
ChatGPT / Codex	`~/.codex/auth.json`
GitHub Copilot	`~/.config/github-copilot/apps.json`