A macOS menu bar app that monitors your Claude usage in real-time so you never hit a rate limit by surprise.
Tokemon sits in your menu bar and shows your current Claude usage at a glance. It reads your session data automatically — no API keys to configure, no manual setup. Just install and go.
Who it's for: Developers on Claude Pro, Team, or Enterprise plans who use Claude Code or claude.ai and want to keep an eye on their rate limits.
- Live usage percentage in your menu bar with color-coded severity (green/orange/red)
- 5 icon styles: percentage text, battery, progress bar, icon + bar, compact number
- Optional monochrome mode to match native macOS menu bar styling
- Click to see detailed usage breakdown with reset timer
- Always-on-top compact window showing usage percentage
- Configurable rows: 5-hour session, 7-day rolling, 7-day Sonnet
- Remembers position between sessions
- Toggle from the right-click context menu
- Configurable warning thresholds (50–90%)
- macOS system notifications when approaching limits
- Session reset notifications when usage drops back to 0%
- Webhook alerts to Slack and Discord with customizable templates
- Manage multiple accounts/profiles
- Switch between profiles from the popover
- Per-profile alert thresholds
- Credentials synced from system Keychain or entered manually
- Usage trend charts with burn rate calculation
- 30/90-day usage history
- Project-by-project token breakdown (via JSONL logs)
- Export to PDF, CSV, or shareable usage cards
- Organization admins can connect an Admin API key
- Monthly budget gauge with cost forecasting
- Per-project cost breakdown
- Auto-alerts at 50%, 75%, 90% of budget
- Team member usage visibility
- Export usage to
~/.tokemon/statuslinefor shell prompt integration - JSON status at
~/.tokemon/status.jsonfor custom scripts - Configurable format with ANSI colors
- One-click shell integration (zsh/bash)
- Native (follows system light/dark), Light, or Dark theme
- Dark theme with warm orange accents
- Download
Tokemon.zipfrom the latest release - Unzip and move
Tokemon.appto/Applications - The app is not yet notarized, so you need to remove the quarantine flag:
xattr -cr /Applications/Tokemon.app
- Double-click to open
Requires Xcode 15+ and XcodeGen.
git clone https://github.com/richyparr/tokemon.git
cd tokemon
xcodegen generate
xcodebuild build -scheme Tokemon -destination 'platform=macOS,arch=arm64' -configuration ReleaseThe built app will be in your Xcode DerivedData directory.
Tokemon reads your usage through two data sources:
-
OAuth (primary) — Queries the usage endpoint using credentials from your macOS Keychain. This gives you accurate 5-hour session percentages, 7-day rolling usage, and reset timers. Credentials are picked up automatically if you're signed into Claude Code.
-
JSONL logs (fallback) — Parses local conversation logs in
~/.claude/projects/to estimate token usage when OAuth isn't available.
No data leaves your machine except calls to the usage endpoint. No telemetry, no analytics, no accounts.
- macOS 14.0 (Sonoma) or later
- A Claude Pro, Team, or Enterprise subscription
- For budget/team features: an Admin API key
Right-click the menu bar icon or press Cmd+, to access settings:
| Tab | What it configures |
|---|---|
| Profiles | Add/manage accounts, sync from Keychain |
| General | Refresh interval, data sources, launch at login |
| Appearance | Theme, menu bar icon style, monochrome mode |
| Notifications | Alert thresholds, Slack/Discord webhooks |
| Terminal | Statusline export format, shell integration |
| Analytics | Usage history charts, PDF/CSV export |
| Budget | Monthly spending limits, cost forecasting |
| Admin | Admin API key connection |
- All data is stored locally on your Mac
- Credentials are stored in the macOS Keychain
- The only network calls are to the usage and token refresh endpoints
- No telemetry, tracking, or third-party services
- The app is not sandboxed (it needs access to
~/.claudefor JSONL parsing)
- Report issues
- Website: tokemon.ai
MIT