πŸ“ˆ GH Trending Explorer 🎲 Surprise me

← all repos

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