Download Tokenometer

Get the disk image

Open the disk image and drag Tokenometer to Applications. There is no installer, no helper daemon, no login item and no account. The app appears in the menu bar and starts reading the logs already on your Mac.

Verify what you downloaded

You do not have to take our word for what is in the file. macOS checks the notarization ticket for you when you open it, and you can check the fingerprint yourself:

SHA-256:

f49a09b70c4f9350331fbe35d298c0393503ab9096d2012e053554878c96ce7d

Compare it against your copy:

shasum -a 256 ~/Downloads/Tokenometer-0.1.0.dmg

And confirm macOS itself is satisfied with the signature and the ticket:

spctl -a -vvv -t install ~/Downloads/Tokenometer-0.1.0.dmg

That should answer accepted, with source=Notarized Developer ID. If it says anything else, do not open it — tell us instead.

First run

Because the build is notarized, macOS opens it without the “unidentified developer” dialog. On first launch Tokenometer reads ~/.claude/projects, builds its history, and puts a meter in the menu bar. A full parse of a large corpus takes a couple of seconds; after that it re-syncs incrementally and the cost disappears.

If the meter shows a dash instead of a number, it has not found any session logs yet — the support page covers what to check.

Turning on the exact gauge

Out of the box, Tokenometer estimates your usage from the logs. That estimate is good, but it is still an estimate. Claude Code itself knows the real account percentages, and it will hand them over if you let Tokenometer install a small status-line helper — Settings → Gauge → Install.

With the helper installed, the app quotes a real account percentage rather than guessing from a log estimate, and the 90% / 95% / 99% alerts become available.

Updating

Tokenometer does not check for updates, because it contains no networking code at all — an update check would be the one thing that made the privacy claim on this site untrue. Check for Updates in the menu opens this page in your browser, and a new version is the same drag to Applications.

Your history lives in ~/Library/Application Support/Tokenometer and is not touched by replacing the app.

Uninstalling

If you installed the status-line helper, remove it first — Settings → Gauge → Uninstall — so Claude Code's own configuration is put back the way it was. Then:

• Drag Tokenometer from Applications to the Trash.
• Delete ~/Library/Application Support/Tokenometer.

That is everything. There is no daemon to stop, no login item to unregister, and no receipt left in a system directory.

Release notes

0.1.0 — 25 August 2026

The first public build.

• Menu-bar meter. A live pace reading — tokens spent against time elapsed — in the menu bar, with the “Now” popover behind it.
• Three windows. The five-hour session, the weekly limit and the separate Opus weekly limit, with the binding one called out.
• Forecasting. A personal baseline learned from your own history, a weekday profile, and a projection band rather than a single confident line.
• Searched advice. Model and effort changes priced against your remaining hours, with the cheapest workable one recommended.
• The exact gauge. An optional, reversible status-line helper that reads real account percentages from Claude Code.
• Alerts. A pace ladder (advisory, heads-up, critical) and one level alert per window at 90%, 95% and 99%.

Known gaps in this build: multi-anchor calibration still resolves against a single anchor, and the week chart does not yet mark the receipts behind each day.