usage for MAC
Free, open-source menu bar app that shows your Claude Code, Codex, Antigravity, Grok CLI and Muse Code quota, and turns red as a limit gets close.
usage Overview
usage keeps your AI coding quota in the Mac menu bar. It shows the 5-hour and weekly limits of Claude Code, Codex, Antigravity and Muse Code with reset countdowns, plus Grok CLI's weekly credit, and turns a quota red as it nears its limit. Click the icon for the full session, weekly and per-project breakdown. Most token and cost figures come from local logs already on your Mac.
It also shows a banner when Claude or Codex has an outage, and its optional Claude Code status line warns about a bloated context window and a cold prompt cache. Optional helpers inside Claude Code include a side pane and shorter replies, and HTML reports show token trends and cost. usage is free and open source under the AGPL-3.0 license, made by lollapalooza. It needs data from at least one of those tools, or a running Claude Desktop app. It is a universal app for Apple Silicon and Intel and needs macOS 12 or later. It is ad-hoc signed and not notarized, so macOS may block the first launch: on macOS 15 or later use Open Anyway in System Settings, Privacy & Security, and on macOS 14 or earlier right-click the app and choose Open.
Key Features
usage shows how much AI coding quota you have left before you run out.
- Menu bar monitor: quotas turn red as they near a limit.
- Five tools: Claude Code, Codex, Antigravity, Grok CLI and Muse Code.
- Reset countdowns: see when session and weekly limits reset.
- Outage alerts: a banner for Claude Code, Claude API and Codex API problems.
- Status line: context and prompt cache warnings in Claude Code.
- Side pane: quotas, conversations and background jobs beside your work.
- HTML reports: token trends, project rankings and cost.
- 16 themes: choose the look of the panel.
What’s New in Version 0.34.9
usage 0.34.9 fixes signature verification of the Mac download.
- Downloaded Mac apps now pass signature verification
- Releases are zipped in a way that keeps the symlinks in the bundled Python framework
- The signature is checked before each release is published
- The download is about 9 MB smaller
usage FAQ
Is usage free?
Yes. usage is free and open source under the AGPL-3.0 license.
Which macOS version does usage need?
macOS 12 or later.
Does usage run on Apple Silicon?
Yes. It is a universal app for Apple Silicon and Intel.
Which tools does usage track?
Claude Code, Codex, Antigravity and Muse Code limits, and the weekly credit of Grok CLI.
Do I need any other software?
Yes. usage needs data from at least one of those tools, or a running Claude Desktop app.
Why does macOS block usage on first launch?
The app is ad-hoc signed and not notarized. On macOS 15 or later use Open Anyway in System Settings, Privacy & Security. On macOS 14 or earlier right-click the app and choose Open.
How do I get Claude Code quotas to appear?
Click Set Up Status Line in the app popover to install the sync hook, then restart Claude Code.
Where does usage get its numbers?
Tokens and cost for Claude Code, Codex, Grok CLI and Muse Code come from local logs. Antigravity quota comes from its own CLI or from Google using the sign-in that CLI stores, and Muse quota from a small background model call through its CLI.
Can I install usage with Homebrew?
Yes, from the project's own tap: brew install --cask aqua5230/usage/usage.
Where does the usage download on usage.FULLMAC.app come from?
The download button leads to the official usage releases on GitHub at https://github.com/aqua5230/usage/releases/latest. usage.FULLMAC.app does not change or repackage the app.
Similar Apps
OrbStackOrbStack is a fast, light and simple way to run Docker containers and Linux machines on your Mac. It is a drop-in replacement for Docker Desktop: your docker and docker compose commands keep working, and on first start OrbStack offers to copy over your existing Docker Desktop containers, images and volumes. It starts in seconds, uses less than 0.1% background CPU on Apple Silicon and returns unused memory to macOS. Besides containers it runs full Linux machines from 16 distributions, and a lightweight Kubernetes cluster for local development. OrbStack is made by Orbital Labs.Developer Tools
QuotaBarIf you use OpenAI Codex with a ChatGPT account, the usage limits reset on a 5-hour and a weekly window, and checking how much is left means opening Codex or ChatGPT. QuotaBar puts the remaining percentage in the Mac menu bar and refreshes it every 60 seconds. Click the icon for a detailed panel with every limit window and its reset countdown, or turn on a small floating HUD that stays on top of other windows.Developer Tools
Stargazer BarStargazer Bar is a small native menu bar app for Mac that keeps an eye on GitHub repositories for you. It puts a live star count in the menu bar, so you can see how a project is doing without keeping a browser tab open, and a click opens a dropdown with the details: star and fork trend charts, release download totals and a maintainer radar. Public repositories are measured by their stars. Private repositories, which have no stars, are measured by what needs your attention: a failing build, an unanswered issue or a new pull request.Developer Tools
Notch So GoodNotch So Good turns the notch of your MacBook into a small status display for AI coding agents. While Claude Code or the OpenAI Codex CLI works, a black pill extends the notch: a 3D character called Peek sits on the left, and a ring on the right shows how much of your 5-hour usage window is left. The more a session needs you, the further Peek climbs out. When a task finishes, fails or runs into a usage limit, the notch opens into a card that says what happened and in which project, and a click jumps to the exact terminal tab, tmux pane included.Developer Tools
Claude UsageClaude Usage is a small native app for people who use Claude Code. In the menu bar it shows your current five-hour session, your weekly usage for all models and for Sonnet, and your pay-as-you-go credits, each with a usage bar and its reset time, without opening Claude Code. It also adds a one-line readout under your Claude Code prompt with the model, how full the context window is and the tokens used, so you can compact a session before it runs out of room. Each terminal pane shows its own readout, also across tmux.Developer Tools
TintpadTintpad is a free, open-source launcher for developers who work with command-line coding agents such as Claude Code and Codex. Press Option-Command-Space anywhere and a black drop falls out of your Mac's notch, or hangs below the menu bar on Macs without one, with your repositories inside. Type a few letters, press Return, and your own terminal opens at that repository with the agent already running, in the mode you used there last.Developer Tools
FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.