Enhed / clawd-usage-winwidget
git clone https://github.com/Enhed/clawd-usage-winwidget.git
v1.18.0 Β· today
Claude usage limits in a tiny Windows widget + tray icon β with pixel Clawd who reacts to your Claude Code sessions, looks after your PC and chats with you, from the widget or your phone. PowerShell, no dependencies.
β
stars, 24h
+66
stars, 7 days Β· #751
+66
stars, 30 days Β· #4,030
66
β
total Β· +66% this week
5
forks Β· 0 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguagePowerShell
LicenseMIT
Created2026-10-16 (4d ago)
Last pushtoday
Watchers1
OwnerUser
GitHub topics
Links
README excerpt
# clawd-usage-winwidget A tiny floating window + tray icon for Windows that shows how much of your Claude plan limits you've used β the same numbers as `/usage` in Claude Code, refreshed every minute. And a pixel Clawd who lives in it and reacts to what your sessions are doing. **English** Β· Π ΡΡΡΠΊΠΈΠΉ - **Official numbers only.** Percentages come from `claude -p "/usage"` β the slash command runs headless, talks to Anthropic with your existing login and **does not call the model or spend tokens**. - **No dependencies.** Plain Windows PowerShell 5.1 + WPF, which ship with Windows. No Node, no npm, no installer. You only need Claude Code itself. - **Clawd.** The crab from Claude Code's welcome screen, built from the same block glyphs and with the same animations. He sleeps when nothing runs, runs around when a session works, waves when a session is waiting for you, sweats near the limit and lies belly-up when it's used up. ## Install Requirements: Windows 10/11 and Claude Code installed and logged in (`claude` on `PATH`). [code] or download the ZIP and unpack it anywhere. Then double-click `start-widget.vbs` (it starts the widget silently, without a console window). Start with Windows β run once in PowerShell from the widget folder: [code] Only one copy runs at a time, so a manual start next to autostart is harmless. Windows hides new tray icons in the overflow (`^`). To keep it visible: Settings β Personalization β Taskbar β Other system tray icons β `clawd-usage-winwidget`. ## What it shows - **Big number** β current session (the 5-hour window), straight from the server. The bar goes green β yellow (60%) β red (85%). - **resets in 3h 03m** β time until the window resets, from the exact reset time in `/usage`. - **WEEK** β weekly limit and time to reset. **FABLE Β· WEEK** β the separate weekly Fable limit; hidden if `/usage` doesn't report it. - **SESSIONS** β how many Claude Code sessions are running, how many are working and how many are waiting for you. Hover for the list: `βΆ` working, `?` waiting (permission, question, dialog β what exactly is in brackets), `β` idle, plus the folder. Handy for catching a forgotten agent quietly burning your limit. Sessions on another machine (a home server, a VM) can be added with `remoteSessions` in `config.json` β a list of URLs or file paths, each returning that machine's live sessions in the shape of `~/.claude/sessions/ .json`: [code] The publisher lists only live sessions; `cwd` is optional. They count for the line and for Clawd and show the `host` in the hover list. A source that fails, hangs or has a `generatedAt` older than two minutes adds nothing. - **Service status** β green "All Claude systems operational", or yellow/red with the active incident and affected components. Click opens status.claude.com. - **Tray icon** β the same percentage as a colored number; the tooltip adds the week and Fable. - Bottom line β your plan and account email (red "not logged in" if auth expi