omgapnt/claudeusage

ClaudeUsage is a small Windows tool that shows how much of your Claude Code subscription you have left, right in your Windows taskbar dock. It plugs into Microsoft PowerToys' Command Palette feature, adding a live band that displays something like "Claude 93%" so you always know your remaining usage at a glance. Clicking the dock band opens a fuller stats page with progress bars for your current five hour session, your weekly limit, and separate limits for each AI model you use, along with countdowns showing when each limit resets and a button to refresh the numbers manually. The dock icon also changes color to orange as a warning once your session usage drops below 20 percent remaining. Under the hood, the extension reads the login token that Claude Code already stores on your computer and uses it to check Anthropic's own usage page every five minutes. The developer states that the tool sends no other data anywhere and does not track usage beyond that single check, so nothing about your activity leaves your machine except the same request Claude Code would already be capable of making. To install it, you clone the project's code repository and run an included setup script, then restart the Command Palette and turn the feature on in its dock settings. If the script is blocked by Windows' default security settings, there is a one line command in the instructions to allow it to run. If something goes wrong, instead of showing a percentage the dock band displays a short message explaining the problem, such as being signed out of Claude Code, a network problem, or an error from Anthropic's service, and there is an optional debug logging mode for troubleshooting further. The tool requires Windows 11, PowerToys with Command Palette support, and an active Claude Code sign in. It is released under the MIT license, meaning it can be used and modified freely.