In the status line
Under the Claude Code prompt: how full the context is, what the session has used and cost, and both limits with the time left until they reset. It works wherever Claude Code runs.
TokenmeterVersion 1.1.0
Your Claude and Codex limits, always in sight
A status line under your prompt and a glass widget on your desktop show the 5-hour and weekly limits, when they reset, and what every session has cost.
Windows 10/11 · macOS 13 or later · one zip, both installers
- Free
- No sign-up
- Source on GitLab
Two ways to keep an eye on it
On your desktop
A small floating card shows both limits in green, orange or red, with a marker for how far into the window you are. If you are on pace to run out before the reset, it tells you when. Use Codex too? A switch on the card shows its limits.
- Plenty left
- Getting close
- Almost out
Small things that add up
Yours to place
It opens from its tray or menu-bar icon and closes when you click elsewhere. Or switch it to a floating window in the menu: drag it anywhere and keep it on top.
Opens with Claude Code and Codex
It starts with your first Claude Code or Codex session, or at sign-in if you prefer.
A ring in the tray
The tray or menu-bar icon fills and changes colour with your 5-hour usage.
Speaks your language
12 languages, picked up from the system or chosen from the menu.
Settings in one window
Launch options, language, view, sync and linked devices: all in one place, behind the gear on the card.
History that stays
The widget keeps a ledger from its first run and a copy on the server, so a reinstall or a new computer gets your history back. Link your devices by ID and password to see them together, and untick any you want left out.
Right by the notch
On a Mac with a notch, Tokenmeter sits beside it: the 5-hour limit on one side, the time to its reset on the other. Hover it and it unfolds with both limits, today’s spend and a Claude / Codex switch. On a Mac without a notch it waits at the top of the screen.
Spend and models
Open the stats view for the full picture: what your Claude Code and Codex sessions would cost at API prices by day, week and month, and how that splits between models.
Screenshots: the macOS widget, with demo data. The Windows widget has the same features.
Every session, itemised
Each Claude Code and Codex session on its own line: title, project, time, tokens and cost, newest first. The expensive ones stand out at a glance.
Install in a minute
One zip holds both installers. Run the one for your system.
Windows 10 and 11Your system
- Download the zip, unzip it and open the tokenmeter folder.
- Double-click install.cmd, or run this in PowerShell:
powershell -ExecutionPolicy Bypass -File install.ps1 - Restart Claude Code. The status line appears under the prompt and the widget’s icon appears in the tray or menu bar with your first session. The limits fill in within seconds.
macOS 13 and laterYour system
- Unzip the download, then run this in Terminal from the tokenmeter folder:
bash install.sh - Restart Claude Code. The status line appears under the prompt and the widget’s icon appears in the tray or menu bar with your first session. The limits fill in within seconds.
Only what you need
Want just the status line? Install it without the widget. Already installed? Turn the status line off from the widget’s menu, or stop the widget from starting with Claude Code: the other part keeps working.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidgetmacOS
bash install.sh --no-widgetClick the icon to open the card, right-click it for the menu. If the widget is not running, start Tokenmeter from the Start menu (Windows) or Applications (macOS).
Update or uninstall
Update
Once a day the widget asks this site whether a newer version exists. When there is one, a dot appears on its refresh button and the menu offers the update. The request carries only the version and the system, and you can switch it off in the menu.
- Download the new zip from this page.
- Run the installer again. Your history and settings stay.
Uninstall
Removes the mod, the widget and its shortcuts.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -UninstallmacOS
bash install.sh --uninstallAdd -KeepHistory (Windows) or --keep-history (macOS) to keep your history.
Numbers sync, your work stays
Spend and token counts by day, model and session sync to tokenmeter.nextwell.top, so your history survives a reinstall and linked devices see each other’s totals. Session titles, project names and prompts never leave your computer; the country is taken from your IP address on upload, and the address itself is not stored. Tick “Don’t sync with the server” in the settings to keep it all local; “Delete history” erases it here and on the server. The limits are asked from Anthropic with your own Claude Code sign-in, which is never refreshed or sent anywhere else.
What you need
- Windows 10 or 11, or macOS 13 or later
- Claude Code with mod support (tested on 2.1.296). The mod API is in early access and may change between releases.
- A Claude Pro or Max subscription, or a ChatGPT plan for Codex: the limits come from your account.
- Node.js for the spend history. Without it the limits still show.
How to read the numbers
- Limits are your account’s own figures, the ones claude.ai shows under Usage, read every five minutes: claude.ai and your other devices count too.
- Cost is what the same tokens would cost at API prices. A subscription is not billed that way: it shows how much you get out of it.
- History is read from the local session logs of Claude Code and Codex. The widget keeps its own ledger from the first run; earlier periods are estimated and drawn paler.
Know before you run out.
Free, open source and quiet: it sits in a corner until you look.
Windows 10/11 · macOS 13 or later · one zip, both installers