AI Usage Monitor Tracks Claude Code and ChatGPT Limits in macOS Menu Bar
AI Usage Monitor is an open-source macOS menu bar utility that displays live usage percentages and reset countdowns for Claude Code and Codex CLI. It prevents unexpected workflow interruptions by alerting developers when usage reaches 90%.
Impact: Medium
Why it matters
Developers can monitor 5-hour session buckets, weekly caps, and credit balances directly from their menu bar without manually running status commands in the terminal.
TL;DR
- 01Install AI Usage Monitor on macOS to track Claude Code and Codex limits in real time.
- 02Get notified at 90% usage threshold to manage session switching before hitting hard caps.
Key facts
- Platform
- macOS
- Supported Tools
- Claude Code, ChatGPT, Codex CLI
- Default Refresh Interval
- 10 minutes
- Default Alert Threshold
- 90%
- License
- Apache-2.0
Real-Time Monitoring for Agentic IDEs
Developers relying on Claude Code and Codex CLI frequently hit rate limits mid-task. ai-usage-monitor brings status awareness directly to the macOS menu bar, rendering /usage and /status metrics continuously.
Authentication and Data Privacy
The app requires no external API keys or login screens. It leverages existing local credentials:
- Claude Code: Reads
Claude Code-credentialsfrom macOS Keychain. - ChatGPT / Codex: Reads
~/.codex/auth.jsonor customCODEX_HOMEpaths.
Metric Tracking and Threshold Alerts
The menu bar displays live usage percentages and countdowns to the next reset window. Key monitored metrics include:
- Claude Code 5-hour session window and 7-day weekly bucket.
- Per-model weekly quotas and pay-as-you-go spend limits.
- ChatGPT primary/secondary rate-limit windows and code review quotas.
- Automated desktop notifications when any usage bucket crosses the 90% threshold.
Try it in 2 minutes
git clone https://github.com/stavrop/ai-usage-monitor.git && cd ai-usage-monitor && ./build.shbash
✓ When to use
- Monitoring Claude Code and Codex usage limits on macOS
- Preventing unexpected rate-limit pauses during vibe-coding sessions
✕ When NOT to use
- Linux or Windows operating systems
- Setups using only raw API keys without Claude Code or Codex desktop logins
What to do today
- Download AI Usage Monitor binary or build from source.
- Grant Keychain read permission on first launch for Claude Code tracking.
Sources