Headroom

Headroom is a native macOS menu bar app that monitors your Claude and Codex API usage limits at a glance. It reads your credentials from the macOS Keychain, fetches real-time utilization data from the Anthropic and OpenAI APIs, and shows color-coded gauges for every rate limit window. When you're approaching a limit, it sends a notification so you're never caught off guard. All processing happens locally — no account to create, no data shared with third parties.

Screenshots

Usage overview with live gauges for each rate limit window

Usage history heatmap showing patterns across days and hours

Token usage breakdown by category over your chosen time window

What it does

•Live usage gauges for 5-hour, 7-day, and model-specific rate limits
•Supports both Claude (Anthropic) and Codex (OpenAI) API limits
•Color-coded menu bar icon: green (clear), yellow (caution), red (warning)
•Smart notifications with configurable thresholds and deduplication
•Automatic token refresh — no re-login needed
•Countdown timers showing when each limit resets