git404hub

what is claudeusage fr?

omgapnt/claudeusage — explained in plain English

Analysis updated 2026-05-18

2C#Audience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A Windows dock extension for PowerToys Command Palette that shows your live Claude Code usage limits, including session, weekly, and per-model percentages.

vibe map

mindmap
  root((ClaudeUsage))
    What it does
      Live usage dock band
      Stats page with progress bars
      Color alert at low usage
    Tech stack
      C#
      .NET 9
      PowerToys CmdPal
    Use cases
      Track Claude Code session limit
      Monitor weekly usage
      Watch per-model limits
    Audience
      Developers
      Claude Code users
    Setup
      Clone repo
      Run install script
      Enable in dock settings

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Keep an eye on remaining Claude Code session usage without opening a separate app.

VIBE 2

Check weekly and per-model usage limits and when they reset.

VIBE 3

Get a visual warning in the Windows dock when session usage is running low.

what's the stack?

C#.NET 9PowerToysWindows 11

how it stacks up fr

omgapnt/claudeusageatum-borg-interactive/road-sdkbabelive/windows
Stars222
LanguageC#C#C#
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Windows 11 with PowerToys Command Palette installed and an active Claude Code sign-in.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install ClaudeUsage and enable it in the PowerToys Command Palette dock.
prompt 2
Explain how ClaudeUsage reads my Claude Code token without exposing it anywhere.
prompt 3
Walk me through building ClaudeUsage from source using build-and-install.ps1.
prompt 4
Help me turn on debug logging for ClaudeUsage to troubleshoot an offline error.

Frequently asked questions

what is claudeusage fr?

A Windows dock extension for PowerToys Command Palette that shows your live Claude Code usage limits, including session, weekly, and per-model percentages.

What language is claudeusage written in?

Mainly C#. The stack also includes C#, .NET 9, PowerToys.

What license does claudeusage use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is claudeusage to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claudeusage for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.