ClaudeMeter: Track Your Claude Code Usage Without the Guesswork

TL;DR: Built a simple macOS menu bar app to track Claude Code usage in real-time. Shows session and weekly limits with color indicators, sends notifications at 80% and 90%, and auto-refreshes every 2 minutes. No more guessing if you're about to hit your limit.

Why I built this

I use Claude Code daily, but I kept hitting my usage limits without warning. The CLI doesn't show usage in real-time, and checking manually is tedious. I wanted something that sits in my menu bar and tells me at a glance where I stand.

Most developers I know have the same problem: you're deep in flow, then suddenly you're rate-limited. By then it's too late to adjust your workflow.

What it does

ClaudeMeter displays your current usage percentage in the menu bar with color indicators:

• 🟢 Green: Under 70% (you're good)
• 🟡 Yellow: 70-90% (getting close)
• 🔴 Red: Over 90% (time to slow down)

It tracks both your 5-hour session limit and 7-day weekly limit. You get notifications at 80% and 90% so you can adjust before hitting the wall.

The app auto-refreshes every 2 minutes and handles wake-from-sleep gracefully with smart retry logic. You can also set it to launch at login.

The problem it solves

Without visibility into usage, you either:

1. Work conservatively and underutilize your quota
2. Work aggressively and get surprised by rate limits

ClaudeMeter gives you the data to make informed decisions. You can see when you're approaching limits and adjust your workflow accordingly.

Try it

📥 Download ClaudeMeter →

Requires macOS 13.0+ and the Claude CLI with user:profile scope.

If you see "Token missing required scope," re-authenticate:

bash
claude /logout
claude

It's free, open source, and runs entirely locally. No data leaves your machine. View source on GitHub.