AI Usage Meter

Shows your Claude 5-hour and weekly usage limits, and how full the context window of your Claude Code session is, so you can finish a task and write your notes before the context gets compacted.

Unofficial community project. Not affiliated with, endorsed by or sponsored by Anthropic. "Claude" is a trademark of Anthropic.

Made by Hans Tandt · MIT licence · Downloads, manuals and SHA-256 checksums: https://hanstandt.be/projects/ai-usage-meter/

Two versions

Folder	What it is	Version
MOD_Version/	The mod for Claude Code (recommended). A band above the prompt, a /meter details pane and short messages, inside Claude Code itself (desktop app and terminal). New features only go here.	1.8.0
source/	The strip for Windows. A small always-on-top window. It stays available as it is; only serious problems are still fixed.	1.6

Each folder has its own README with the full details, how to build it and how to remove it.

What it does and does not do

• It only reads the usage figures that Claude Code itself reports. It never reads your Claude login or any credentials, and it sends nothing anywhere.
• Its only network use is an optional, once-a-day update check that reads a small version file from hanstandt.be. It never downloads or installs anything by itself. You can switch it off.

What it changes on your PC

• The mod is installed with Claude Code's own plugin commands (claude plugin ...) and removed the same way. It writes its figures in %USERPROFILE%\.claude\.
• The strip copies itself to %LOCALAPPDATA%\AIUsageMeter, adds a Start menu shortcut and a per-user entry in Installed apps (no admin rights), and adds its add-on folder to %USERPROFILE%\.claude\settings.json after saving a backup of that file. It starts with Windows only if you tick "Start automatically when I log in to Windows" in its Settings (off by default). Uninstall from Installed apps, or from the strip's Settings: this undoes all of it.

Building from source

• Mod: TypeScript files loaded by Claude Code; see MOD_Version/README.md.
• Strip: builds with tools that ship with Windows 10/11, no PowerShell involved: source\overlay\build.cmd. See source/README.md.

The released exe is not code-signed, so Windows SmartScreen may warn. Check the SHA-256 checksum shown on the download page, or build it yourself from this source.

Licence

MIT, see LICENSE.