Pin your Claude Code, Codex, Antigravity & Grok
quota to the menu bar.
A tiny menu bar app for macOS (and system tray app for Windows) that shows how much of your AI quota is left, like a battery percentage for tokens.
First launch blocked by macOS?
Built for developers who burn tokens.
Stop guessing if you’re about to hit the rate limit mid-refactor.
5-hour & 7-day quota at a glance
Both Claude Code session (5h) and weekly (7d) percentages live in the menu bar. Click for a full popover with per-project usage and cost.
Claude Code, Codex, Antigravity & Grok, one app
Track Anthropic, OpenAI, Google, and xAI quota side by side. Codex is auto-detected from ~/.codex/sessions/ with no setup; Antigravity uses the sign-in its own CLI already stores.
One-click HTML reports
Today, week, month, or all-time: get a shareable HTML report with token / cost trends, top projects, and model breakdown. Project names hide by default for client-safe sharing.
16 visual panel themes
Matrix digital rain, Windows 95, retro newspaper, midnight aquarium, World Cup FIFA HUD, Lepidoptera blueprint. Pick a mood for your menu bar pop-out.
Claude Code helpers
Keeping an eye on quota and context while you code
Notifications before you hit the wall
At 70% context, the status line nudges you to /clear or /compact. The number turns yellow at 50% and red at 80%, and a missed prompt cache tells you why.
Token Saver
Claude Code and Codex answer shorter and plainer, and long chats don’t drift back to wordy. Code, commands and error messages stay byte-exact. In Codex, trust the hook in /hooks first.
Beginner Mode
After each answer, up to three terms show up above the input box with a one-line plain explanation. Terms you mark as understood come back later as a short quiz. Uses a little Claude quota.
Quota-Aware Mode
When quota runs low, Claude tells you what’s left and when it resets before starting anything big, so you can do a smaller piece or wait. Covers Claude Code, Codex and Antigravity, with no extra model calls.
Where the numbers come from
How usage reads each tool
Local-first by design
Claude Code and Codex numbers come from files already on your computer, and Claude Desktop alone is enough for Claude quota. Antigravity is the exception: it asks Google with its CLI’s own sign-in. Every outbound request is listed in SECURITY.md.
Grok CLI, too
Reads Grok CLI’s own local log to work out its weekly quota percentage. Each request’s tokens count toward today’s cost and project totals, just like Claude Code and Codex.
Now your CLI picks up where you left off
The web and desktop apps keep your history automatically: close them, reopen, it’s all there. The CLI keeps it too, but you need to know the command to pull it back up. Resume makes that automatic: open a new session and it picks up where you left off, no command to remember, no re-explaining. It now also runs a daily health check on your logs. When it spots token waste, the handoff adds a one-line heads-up; say “show me” for the findings and fixes. Reads local files.
Your quota, right inside Claude Code
On macOS and Windows, see your quotas, conversations, and background jobs—including subagents started with the Agent tool and their status—inside Claude Code. Conversations waiting for your permission or MCP input are marked in yellow. After enabling the pane, it opens on the right automatically at terminal widths ≥144 columns; otherwise, enter /usage-dash. A notification appears when another Claude conversation finishes or starts waiting for you.
Pick a panel that fits your mood.
16 built-in themes. Change anytime from the popover toolbar.
Install in 10 seconds.
4 ways to get it running. All free, all AGPL-3.0.
Homebrew
One command. brew upgrade keeps it current.
brew install --cask aqua5230/usage/usageDownload .app
Latest usage.app.zip from GitHub Releases. Unzip, then drag to /Applications.
System tray
Latest usage-windows.zip from GitHub Releases. Unzip and run usage.exe. You can also show a quota label in the taskbar; right-click it to open the tray menu.
uvx (no install)
Terminal interface only, with no menu bar or tray. Works on Linux too; uv brings its own Python.
uvx usage-climacOS blocked the first launch? Open System Settings → Privacy & Security, scroll down, and click Open Anyway. On macOS 14 or earlier, right-click usage.app → Open instead. Windows showed “Windows protected your PC”? Click More info → Run anyway. Claude Code users: after installation, click Set Up Status Line in the menu and restart Claude Code to show quota.