A macOS menu-bar app for Claude, Codex, and Cursor usage.
Requires macOS 14 or newer on Apple silicon.
- Open the latest release and download its DMG under Assets.
- Drag AgentUsageBar to Applications.
- Open AgentUsageBar once. macOS will block it because Apple has not notarized it.
- Open System Settings → Privacy & Security, click Open Anyway, then confirm Open.
The last two steps are required only on first launch.
- Claude session, weekly, scoped, and monthly-budget usage
- Codex rate-limit windows, model meters, credits, and budgets
- Cursor total, API, and Auto usage with the billing-cycle reset
- Five-minute refreshes that keep the last good values during an outage
- Configurable provider folders, appearance, and start at login
- No row or menu-bar segment for providers that are not installed
AgentUsageBar stores no credentials. It reads the sessions that the provider apps already own and makes usage requests from short-lived helper processes.
| Provider | Session source | Usage endpoint |
|---|---|---|
| Claude | Keychain item Claude Code-credentials |
api.anthropic.com/api/oauth/usage |
| Codex | ~/.codex/auth.json |
chatgpt.com/backend-api/wham/usage |
| Cursor | Cursor's local SQLite database, opened read-only | cursor.com/api/usage-summary |
Cursor's dashboard endpoint is undocumented and may change.
Install the Xcode command-line tools, then run:
./setup.shThe script builds, installs, and launches the app. Run it again to update without losing
settings, or run ./setup.sh --clean to remove stale state without rebuilding.