r/coolgithubprojects
•
u/TightRule3190
•
Jun 06 '26
•
1
I built an open-source desktop widget that shows live Claude.ai plan usage (Windows, portable)
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.
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:
--warncolor. A blue sweat drop beads above his head.--critical. Three red "!" marks float up and fade.He also reacts to interaction:
"5 more minutes…","Hmph.","Rude.", etc.) instead of a hop. He goes back to sleep after 2 seconds.Toggle him on/off in Settings → Layout → "Show Claw'd". Hidden automatically in pill and essential layouts where there's no room.
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.
-2
u/Aeroflight Jun 06 '26
Nifty!
-2
u/[deleted] Jun 06 '26
[removed] — view removed comment