claudecodeusage

Claude Usage

A lightweight macOS menubar app that displays your Claude Code usage limits at a glance — and alerts you when a Claude Code session needs your attention.

Built by @richhickson

Features

Usage tracking
- 📊 Session, Weekly & per-model limits - including model-scoped weekly caps (e.g. Fable/Opus) as Anthropic rolls them out
- 💵 Overage tracking - extra-usage spend against your monthly limit
- 🚦 Color-coded status - Green (OK), Yellow (>70%), Red (>90%)
- 🎨 Menu bar styles - Native (monochrome template icon, colors only when a limit runs hot), Tinted (icon colored by usage), or classic Emoji — plus your choice of metric (session/weekly/model %, spend, or icon only)
- ⏱️ Time until reset for each limit
- 🔄 Auto-refresh every 5 minutes, with retry on network/keychain hiccups and refresh on wake from sleep
- 👥 Multiple accounts - every Claude Code login on the machine (one per CLAUDE_CONFIG_DIR) appears in an account dropdown, labelled by full account email; the menu-bar percentage and colour follow the selected account

Session alerts (opt-in)
- 🔔 Menu bar bell naming the project that's waiting for your permission or input (a count when several are)
- 💬 macOS notifications when a session needs you - with an on/off toggle, permission status, and a test button
- 📋 Live session list in the popover: needs you 🔔 / working ⚙️ / finished ✅
- 🖱️ Click-to-focus - click a session (or its notification) to jump to the exact Terminal/iTerm2 tab it's running in; alerts clear once you've visited the session

Claude status alerts
- 🌡️ Outage notifications - get notified when status.claude.com reports a problem, and again when service recovers (checked every 5 minutes; toggle in settings)
- 🟢 Status line in the popover with a severity dot, linking to the status…