Repository navigation
GrokUsageBar 0.2.5
Menubar usage for Grok Build — same weekly limit as /usage.
What's new
- Pace: weekly usage vs expected, and when you would hit 100% at this rate
- Configurable alerts at 50 / 80 / 90 / 100% (80 and 100 on by default), plus an optional pace alert, once per period
- Token refresh shares the grok CLI lock (
auth.json.lock), so the app and the CLI no longer race - Sign out removes only this app's entry, not the whole
auth.json - Keeps the last reading (dimmed, orange dot) when a refresh fails; refreshes on wake and when the network returns
- A missing usage field is reported instead of showing a fake 0%
Highlights
- Weekly limit from
GET /v1/billing?format=credits(creditUsagePercent) - Rolling 7-day window with range + “resets in N days”
- Plan badge (JWT
tier1 → SuperGrok, 5 → SuperGrok Heavy) - Product breakdown (Build, Chat, Imagine, …)
- Monthly credit units as secondary info
Install
- Download
GrokUsageBar-0.2.5-macos-notarized.zip - Unzip → move
GrokUsageBar.appto Applications - Open the app (Gatekeeper should accept it as notarized).
- Ensure you are logged in with
grok login
Build
- Bundle ID:
com.sergiocomeron.GrokUsageBar - Developer ID Application + notarized (team 6PUHQ5CYQS)