usage
macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no telemetry. HTML
What is usage?
macOS menu bar & Windows tray app pinning Claude Code, Codex, Antigravity & Grok CLI quota, burn rate, and cost to your screen. Local-first, no telemetry. HTML reports, 16 themes.
Overview of usage
What it is
usage is a macOS menu bar and Windows system tray application that displays real-time quota, burn rate, and cost information for Claude Code, Codex, Antigravity, Grok CLI, and Muse Code. It is local-first and does not collect telemetry. It also generates HTML reports and offers 16 themes.
Key features
- Displays session and weekly limits with reset countdowns for Claude Code, Codex, Antigravity, and Muse Code, plus Grok CLI's weekly credit.
- Reads tokens and cost from local logs for Claude Code, Codex, Grok CLI, and Muse Code. Antigravity quota is obtained from its own CLI or from Google's official endpoint using stored sign-in.
- Warns about a bloating context window and cold prompt cache for Claude Code. Shows an orange-red banner when Claude Code, Claude API, or Codex API is down or degraded.
- Provides optional helpers inside Claude Code: a side pane, shorter replies (Token Saver), a progress hand-off for new sessions (Progress Concierge), and quota-aware planning.
- Generates offline HTML reports of token trends and cost, with project rankings and a Year in Review heatmap. Supports export to .html, .csv, or .png.
- Offers 16 panel themes and a drag-and-drop interface to reorder quota cards. The UI follows the system language in Traditional Chinese, Simplified Chinese, English, Japanese, or Korean.
Use cases
- Monitoring Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quotas to avoid hitting limits during long refactoring sessions.
- Tracking token usage and cost trends across multiple AI coding tools from a single menu bar or tray icon.
- Receiving early warnings about context window bloat, cold prompt cache, or service outages.
- Generating offline reports for project cost analysis and quota planning.
Getting started
macOS (Homebrew, recommended):brew install --cask aqua5230/usage/usageWindows (portable): Download usage-windows.zip from the latest release, unzip, and run usage.exe.Linux and terminal only (uvx):uvx usage-cliFor first launch, click the menu bar or tray icon. If blocked by macOS Gatekeeper or Windows SmartScreen, follow the instructions in the repository README.
License and pricing
License: AGPL-3.0. Pricing: open source.
Based on the project's public README and repository metadata.