🐾 usage
macOS · open source · AGPL-3.0

Pin your Claude Code & Codex
quota to the menu bar.

A tiny macOS menu bar app that shows how much of your AI quota is left — like a battery percentage for tokens. Reads local files only. Zero API calls.

usage popover
Zero API calls to Anthropic or OpenAI
Local-only — reads files on your disk
No telemetry, no accounts, no cloud

Built for developers who burn tokens.

Stop guessing if you're about to hit the rate limit mid-refactor.

5-hour & 7-day quota at a glance

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.

🤝

Claude Code + Codex, one app

Track Anthropic and OpenAI quota side by side. Codex auto-detected from ~/.codex/sessions/ with no setup.

🔒

Local-only by design

Reads a status file written by an installed statusLine hook + Codex session JSONL logs. Never calls the Anthropic or OpenAI API. Doesn't touch your Keychain.

📊

One-click HTML reports

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.

🎨

9 visual panel themes

Matrix digital rain, Windows 95, retro newspaper, midnight aquarium, World Cup FIFA HUD — pick a mood for your menu bar pop-out.

🌐

5-language interface

Auto-detects your macOS language. Supports 繁體中文, 简体中文, English, 日本語, 한국어 — all strings translated, not just menus.

Install in 10 seconds.

Two ways to get it running. Both free, both AGPL-3.0.

RECOMMENDED

Homebrew tap

One command. brew upgrade keeps it current.

brew tap aqua5230/homebrew-usage
brew install aqua5230/homebrew-usage/usage
DIRECT

Download .app

Latest usage.app.zip from GitHub Releases — unzip, drag to /Applications.

→ Open Releases page

Pick a panel that fits your mood.

Nine built-in themes. Change anytime from the popover toolbar.

Your AI usage, in one shareable page.

Generate 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.

HTML usage report