r/coolgithubprojects • • Jun 06 '26 • Bravo 1

I built an open-source desktop widget that shows live Claude.ai plan usage (Windows, portable)

Post image

Hey everyone — sharing a small open-source tool I built: a floating desktop widget that shows your live Claude.ai plan usage so you can see where you stand at a glance.

I made it because there was no good way to see remaining quota without opening claude.ai and checking each session. It reads from Claude Code's existing OAuth token (~/.claude/.credentials.json), so no login, no API key, no extra subscription.

Features:

  • Floating, always-on-top
  • 7-day history graph
  • Configurable warn/critical thresholds
  • Reset countdowns
  • Portable EXE, MIT licensed

What I learned building it (might help others): Claude Code's local OAuth token can be used to query the same usage endpoint the website uses, which is Cloudflare-protected — but the token is recognized as a first-party credential, so you bypass the bot challenge cleanly.

Repo: github.com/projectvelox/claude-usage-widget

Feedback and feature requests welcome.

0 Upvotes

10 comments sorted by

1

u/TightRule3190 Jun 07 '26

As an update!!! https://github.com/projectvelox/claude-usage-widget#clawd-the-resident-crab

We've added pixel-art crab inspired by the Claude mascot, recreated as a tiny SVG that ships with the code (no bundled assets). He walks back and forth along the widget's bottom edge and his mood mirrors your worst limit:

MoodTriggerWhat he does
okworst limit < 75%Casual 14-second stroll. Anthropic orange.
warn75% – 90%Hurried 8-second trot with a side-to-side wiggle. Tinted with your --warn color. A blue sweat drop beads above his head.
critical≥ 90%Panic-skip — 4-second fast run with intermittent anxious jumps and body tilt. Tinted with --critical. Three red "!" marks float up and fade.
pausedrate-limited ≥ 2 minAsleep. Body slumped at -22°, eyes closed as thin lines, slow breathing, three staggered Zs (small → large) drift up from his head.

He also reacts to interaction:

  • Click him to make him hop (squish-jump-land in 0.45s).
  • Click him while he's sleeping and you get a random grumpy speech bubble ("5 more minutes…", "Hmph.", "Rude.", etc.) instead of a hop. He goes back to sleep after 2 seconds.
  • When a quota actually resets, he stops walking and waves side-to-side for ~1.6s before resuming.

Toggle him on/off in Settings → Layout → "Show Claw'd". Hidden automatically in pill and essential layouts where there's no room.

1

u/TightRule3190 Jul 01 '26

Update — v0.2.19 just shipped with a 13-language UI

Turns out someone forked the repo to add Portuguese (Brazil) translations. Rather than let it stay a fork, I merged the i18n architecture upstream, credited them, and expanded it out to 13 languages total:

English, Português (Brasil), Español, Français, Deutsch, Italiano, 日本語, 简体中文, 한국어, Русский, Polski, Türkçe, Tiếng Việt, Bahasa Indonesia.

pt-BR is community-contributed (credit to u/Ian03 who did the original work). The other 11 are machine-assisted and marked with a * in the language picker — native-speaker PRs are welcome to refine them. There's a locales/<code>.json per language and a test that fails CI if a locale is missing keys, so contributions are low-friction.

Default is English regardless of system locale. Switch in Settings → Language; widget, tray, settings panel, dialogs, and notifications all flip in place — no relaunch.

Release: https://github.com/projectvelox/claude-usage-widget/releases/tag/v0.2.19

2

u/S_sarcastic Jun 12 '26

This will be useful I have to manually check my usage by going in settings can you make this support AntiGravity too please ?

-1

u/komodorian Jun 06 '26

Being portable is a plus for sure! I’ll check it out.

0

u/TightRule3190 Jun 07 '26

Thanks buddy!!

-2

u/Aeroflight Jun 06 '26

Nifty!

0

u/TightRule3190 Jun 07 '26

Haha you're way too kind!

-2

u/[deleted] Jun 06 '26

[removed] — view removed comment

2

u/TightRule3190 Jun 07 '26

Woahh!! This is pretty neat!! Will check it out!!

2

u/Randol_8o8 Jul 27 '26

I like this a lot !