A tiny macOS menu bar app that shows how much of your AI quota is left — like a battery percentage for tokens. Reads your local files directly — never phones home to Anthropic or OpenAI.
Stop guessing if you're about to hit the rate limit mid-refactor.
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.
Track Anthropic and OpenAI quota side by side. Codex auto-detected from ~/.codex/sessions/ with no setup.
Reads a status file written by an installed statusLine hook + Codex session JSONL logs. Never connects to Anthropic or OpenAI to check usage. Doesn't touch your Keychain.
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.
Matrix digital rain, Windows 95, retro newspaper, midnight aquarium, World Cup FIFA HUD, Lepidoptera blueprint — pick a mood for your menu bar pop-out.
Auto-detects your macOS language. Supports 繁體中文, 简体中文, English, 日本語, 한국어 — all strings translated, not just menus.
Install a curated team of Claude Code subagent personas — a one-person law practice, a solo software studio, and more — straight into ~/.claude/agents/, then call one by name in your next conversation.
A menu-bar toggle that asks Claude Code — and Codex CLI too, if it's installed — to answer more tersely for the whole session: same substance, fewer words, while code, commands, and error messages stay byte-exact.
An optional menu-bar critter — phoenix for Claude, dragon for Codex — that speeds up as your local token burn climbs, so you can feel your pace at a glance without reading a single number.
When your context window hits 70%, the status line nudges you to /clear or /compact to prevent token waste. You can also opt-in to system notifications for quota limits and recoveries.
Love the terminal? Run the rich TUI dashboard with python3 main.py --tui, or generate deep analytics with python3 usage_cli.py report.
Only use one tool? Hide the Claude Code or Codex section from the menu bar and panels completely with a single click.
The web and desktop apps keep your history — close them, reopen, it's all there. The CLI didn't. Resume hands that power to the CLI: open a new session and it picks up where you left off automatically, 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 only — never connects to any API.
Two ways to get it running. Both free, both AGPL-3.0.
One command. brew upgrade keeps it current.
brew install --cask aqua5230/usage/usageLatest usage.app.zip from GitHub Releases — unzip, drag to /Applications.
Ten built-in themes. Change anytime from the popover toolbar.
matrix
win95
newspaper
cloud_observation
aquarium
prism_arcade
black_hole
world_cup
lepidoptera
classicGenerate an HTML report with token spend, cost, top projects, and model distribution — plus an AI Tool Update Digest summarizing recent changes, and a year-in-review page with a GitHub-style contribution heatmap and a "Wrapped" card. Send to your manager. Use as a client invoice attachment. Project names hide by default.
