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 — pick a mood for your menu bar pop-out.
Auto-detects your macOS language. Supports 繁體中文, 简体中文, English, 日本語, 한국어 — all strings translated, not just menus.
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
classicGenerate an HTML report with token spend, cost, top projects, and model distribution. Send to your manager. Use as a client invoice attachment. Project names hide by default.
