megaproxy/claude-usage-widget
1
0
Fork 0
Code Issues Pull requests Projects Releases 3 Packages Wiki Activity Actions

3 releases 3 tags

RSS feed
  • v0.1.0 79fc144235

    v0.1.0 Stable

    megaproxy released this 2026-05-09 13:51:02 +00:00 | 9 commits to main since this release

    Claude Usage Widget v0.1.0

    First public build. Always-on-top Windows desktop widget that shows your real Claude subscription usage — the same percentages claude /usage displays — refreshed every 5 minutes.

    What it shows

    • Current 5-hour session % with reset countdown
    • Weekly all-models + Weekly Sonnet bars
    • Per-model breakdown for the current session block (Opus / Sonnet / Haiku, derived from your local Claude Code transcripts)

    Install

    1. Download Claude Usage Widget_0.1.0_x64-setup.exe below.
    2. Run it. Windows SmartScreen will warn "unrecognized publisher" — click More info → Run anyway (the binary isn't code-signed).
    3. Widget pops up upper-left. Drag where you want. Resize as you like.

    Requirements

    • Windows 10 or 11 with WebView2 Runtime (preinstalled on Win11)
    • Claude Code installed and signed in (native Windows or inside any WSL distro — auto-detected)

    How it works

    The widget spawns claude via a hidden pseudo-TTY, sends /usage, and parses the rendered output. No API keys, no admin tokens, nothing leaves your machine. Configuration lives at %APPDATA%\claude-widget\config.json.

    A tray icon next to the Windows clock lets you bring the widget back if it ever gets lost off-screen.

    Known limitations

    • The auto-detected claude command defaults assume wsl.exe -d <distro> for WSL installs. If your distro has a non-standard name and claude isn't in the login PATH, override it in Settings.
    • /usage parser depends on Anthropic's rendered output format. If a Claude Code update changes that text, the widget shows "no /usage data" and you'll see the raw output in Settings → Test /usage now → "raw output".
    • Source: https://git.rdx4.com/megaproxy/claude-usage-widget
    Downloads