A macOS menu bar app that displays your Claude Code usage at a glance.
- Menu bar donut chart -- shows 5-hour session and 7-day weekly utilization as nested rings
- Detailed popover -- 5-Hour Session, 7-Day Weekly, and 7-Day Sonnet rate limits with progress bars and reset times
- Auto-refresh -- configurable polling interval (1 / 3 / 5 / 10 / 15 / 30 / 60 min)
- Launch at Login -- optional auto-start on macOS boot
- macOS 14.0 (Sonoma) or later
- Claude Code CLI installed and signed in
| Feature | Pro | Max |
|---|---|---|
| 7-Day Weekly usage | ✓ | ✓ |
| 7-Day Sonnet usage | ✓ | ✓ |
| 5-Hour Session usage | — | ✓ |
The 5-Hour Session row is only shown on Max plan. The Anthropic API does not return 5-hour session data for Pro plan subscribers, so that section is hidden automatically.
CCMeter reads the OAuth credentials that Claude Code stores in the macOS Keychain (service: Claude Code-credentials). No password prompt is required -- the app reads credentials via the same security CLI that Claude Code itself uses, which macOS always permits without confirmation.
The app never performs its own OAuth login flow and never modifies Keychain entries. It only reads the token that Claude Code has already saved.
Privacy: All data is processed locally on your Mac. Your credentials and usage statistics are never sent to any server other than Anthropic's official API endpoints.
Xcode (or the Xcode Command Line Tools with Swift 5.9+) is required.
git clone https://github.com/s-age/ccmeter.git
cd ccmeter
./Scripts/build.sh --installThis builds a release binary, assembles CCMeter.app, code-signs it, and copies it to /Applications.
| Flag | Description |
|---|---|
--clean |
Clean build artifacts before building |
--test |
Run tests before building |
--install |
Install to /Applications after building |
--skip-icon |
Skip app icon generation |
--no-sign |
Skip code signing |
MIT