Free & open source for macOS

Never hit a |
by surprise again

Tokemon floats on your screen showing Claude usage in real-time. Track session limits, weekly utilization, burn rate, project costs, and team budgets — all from your menu bar.

$ brew tap richyparr/tokemon && brew install --cask tokemon
Tokemon popover showing usage trend chart and burn rate

Your usage, always visible

A compact floating window that stays on top of everything — fullscreen videos, browsers, your IDE. No clicking, no switching.

Coding in your editor
Coding in your editor
Browsing the web
Browsing the web
Watching fullscreen video
Watching fullscreen video
Floating window close-up
Floating window close-up
The problem

You don’t know if you’ll hit the limit before your session resets

Claude rate limits reset on a rolling window. Without visibility into your usage trend, you’re flying blind — burning through tokens with no idea when you’ll hit the wall.

Tokemon charts your usage over 24 hours and 7 days, calculates your burn rate per hour, and estimates exactly when you’ll hit your limit at the current pace.

Estimated limit: 12h 59m — at your current burn rate of 6.5%/hr, you have plenty of runway. But if it drops to 2 hours? You’ll know immediately.
Usage trend chart with burn rate
The problem

You have no idea which projects are eating your tokens

If you’re billing clients for token usage or managing a budget across projects, you need to know where tokens are going. Manually tracking this is impossible.

Tokemon parses your local session logs and breaks down token usage by project — showing exactly how many tokens each codebase consumed over 7, 30, or 90 days.

Billing clients? Now you can show that “refchecks” used 1.2B tokens and “candidreei” used 448M. Export the data to PDF or CSV and attach it to your invoice.
Project breakdown showing per-project token usage
The problem

Your team is burning through API budget with zero visibility

You’ve set a monthly budget but have no idea how much has been spent, what the daily run rate is, or whether you’ll blow past the limit before month-end.

Connect your Admin API key and Tokemon gives you a real-time budget gauge — dollars spent, days remaining, and a forecast that tells you if you’re on pace or heading for an overage.

$5.43 of $100 spent, 9 days left. Forecast says you’ll finish at $8.15 — well under budget. But auto-alerts at 50%, 75%, and 90% ensure you’ll never be caught off guard.
Budget tracking with gauge and forecast
The problem

As an admin, you can’t see who’s using what

Managing a team’s Claude usage shouldn’t require digging through billing dashboards. You need a quick view of total cost, total tokens, and usage patterns across your organization.

Tokemon connects to the Admin API and surfaces organization-wide analytics — total cost, input/output tokens, cache usage, and a usage history chart spanning 7 to 90 days.

Team leads and finance: See $3.14 total cost, 2.2M tokens across the org, and a usage history that shows exactly when spikes happened. Export it for your monthly report.
Organization usage analytics
The problem

You need to justify token costs to clients or management

“We used a lot of tokens” doesn’t cut it. You need real data in a format people can read — whether you’re a freelancer billing clients or a team lead reporting to management.

Tokemon exports your usage data as PDF reports or CSV files. Per-project breakdowns, date-range summaries, cost data — everything formatted and ready to attach to an invoice or share in a meeting.

Freelancers: Export a 30-day PDF showing each client project’s token usage and cost. Attach it to your invoice. No more guessing, no more disputes.
Usage history and analytics for export

And everything else you'd expect

Slack & Discord alerts

Webhook notifications before you hit limits. Set thresholds at 50%, 70%, 90% — get a ping in your team channel, not a surprise in your IDE.

Terminal statusline

Live in the terminal? Export usage to your shell prompt via ~/.tokemon/statusline. One-click zsh/bash setup with ANSI color coding.

Usage summaries by period

Filter analytics by 24h, 7 days, 30 days, or 90 days. See how your usage patterns change over time and identify high-consumption periods.

Multi-profile support

Manage personal and work accounts with independent credentials and alert thresholds. Switch between profiles instantly.

5 menu bar styles

Percentage, battery, progress bar, icon + bar, or compact number. Optional monochrome mode to match native macOS styling.

Three themes

Native macOS (follows system), Light, or Dark with warm orange accents. Your choice across every window and panel.

Start monitoring in 30 seconds

Free, open source, no account needed. Just install and go.

$ brew tap richyparr/tokemon && brew install --cask tokemon