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.
Claude UsageVersion 1.0.0
Your Claude 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
- Runs locally
- 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.
- Plenty left
- Getting close
- Almost out
Spend, models and sessions
Open the stats view for the full picture: what your sessions would cost at API prices by day, week and month, how that splits between models, and your latest sessions with title, project, time, tokens and cost.
Screenshots: the Windows widget, with demo data. The macOS widget has the same features. It is built on your Mac during install, so there are no screenshots of it here.
Small things that add up
Yours to place
Drag it anywhere, keep it on top of other windows or hide it to the tray or menu bar.
Opens with Claude Code
It starts with your first 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.
Calm when you want it
Animations can be switched off from the menu.
Keeps its own history
Claude Code deletes old session logs after a while. The widget keeps a ledger from its first run, so your history stays.
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 claude-usage 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 opens with your first session. The limits fill in after the first reply.
To update, run the installer again: your history and settings stay. To uninstall:
powershell -ExecutionPolicy Bypass -File install.ps1 -UninstallmacOS 13 and laterYour system
- Once: install the Xcode Command Line Tools. The widget is built on your Mac during install.
xcode-select --install - Unzip the download, then run this in Terminal from the claude-usage folder:
bash install.sh - Restart Claude Code. The status line appears under the prompt and the widget opens with your first session. The limits fill in after the first reply.
To update, run the installer again: your history and settings stay. To uninstall:
bash install.sh --uninstallTo open the widget by hand, look for Claude Usage in the Start menu (Windows) or in Applications (macOS). If it is hidden, click its tray or menu-bar icon.
Updates
Once a day the widget asks this site whether a newer version exists and says so in its menu. The request carries the version and the system (Windows or macOS) and nothing else. You can switch it off from the menu. To update, download the new zip and run the installer again.
Everything is local
Limits come from a file the status line writes on your computer, and the spend history is read from Claude Code’s own session logs. Nothing is uploaded, and there is no account or sign-in. The update check is the only thing the widget sends.
This site counts visits, downloads and update checks without cookies or trackers, and never stores addresses.
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 Pro or Max subscription: the limits come from your account.
- Node.js for the spend history. Without it the limits still show.
- On macOS, the Xcode Command Line Tools: the widget is built on your Mac during install.
How to read the numbers
- Limits are the percentages Claude reports with each reply, so they refresh when you use Claude Code, in any session.
- 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 Claude Code’s local session logs. 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.
Source on GitLab