Madhur Shrimal

Navigate

← Back to projects
Headroom

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.

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