Pace & 7-day history
A bar, line or area graph for each ring, plus a projection: “On track (≈70% at reset)” or “At this pace you'll hit 100% by Fri 3 PM.”
v0.9.7 · Free & open source · macOS 14+
Know your Grok limits at a glance.
GrokGauge lives in your Mac's menu bar and shows your weekly SuperGrok usage as rings that turn green, orange and red, so the weekly limit never sneaks up on you.
brew install --cask stevencombs/tap/grokgauge
Installs the Grok CLI too. Then run grok login once.
Native Swift · Apple silicon & Intel · MIT licensed · Unofficial, not affiliated with xAI or Cursor
Lives in your menu bar. Pick your style: the higher percent, both numbers, days to reset, or just a tinted logo.
Welcome tour
Get started in seconds.
The first time GrokGauge opens, a friendly 8-step tour shows you around. It checks your Grok sign-in, explains the rings with your color levels, the menu bar, settings and sync, and pace. Skip it anytime, or replay it later from the gear menu's Show Welcome Tour…
↩
Quick to click through
Back, Next and Skip on every card, with step dots. Return goes on, Esc skips.
◐
Light, dark & VoiceOver
Follows your Mac's appearance, and every card reads well with VoiceOver.
①
Once per Mac, no nagging
It shows once on each Mac. The last card offers an optional tip, and “Maybe later” means it never asks again.
Shown with sample data. Steps 4–7 cover the shared pool, the menu bar, settings & sync, and history & pace.
Features
Everything about your week, one click away.
Click the gauge (or press ⌃⌥G) and the whole picture drops down.
Grok pool by product
See what's eating your pool: Chat, Imagine, Voice, Build, API, Grok Bot and Cursor. Pick which ones show and how they're sorted.
Reset countdown
Days to reset, a live countdown and the exact reset time in your time zone.
xAI & Cursor status
Two dots tell you if a slowdown is on their end. Click one to open the status page.
What's new from xAI
New Grok app releases, xAI news and Grok CLI updates, with the update command (brew upgrade --cask grok-build or grok update) ready to copy.
Extra Usage Credits
Your prepaid Grok credit balance, right next to your usage.
Quick-open buttons
Jump straight to Grok, Grok Bot or X from the dropdown.
Light & dark
Follows your Mac's appearance, with a colorblind-friendly color preset too.
⇄
Synced across Macs
Point GrokGauge at a folder your Macs already sync. Your settings and every Mac's readings follow you.
🔔
Heads-up alerts
A notification when a ring reaches your warning or critical level, once per week each.
⌨
Global shortcut
Press ⌃⌥G from anywhere to open the dropdown.
⏻
Launch at login
Set it once and it's there every time your Mac starts.
›_
Guided Grok CLI setup
No Grok CLI yet? GrokGauge walks you through installing it and running grok login.
⚙
Make it yours
Reorder or hide sections, pick ring and graph styles, and set your own color levels.
Sync between Macs
One folder. One status. Done.
Pick one folder your Macs already sync, like Google Drive, iCloud Drive or Dropbox. Your settings and 7-day usage history sync through it, and each has its own switch. One status line tells you it's in sync and which Macs are in, with a single Sync Now.
- All your Macs end up in the same folder. GrokGauge finds the one your other Macs use.
- Readings from every Mac are combined (highest wins), never added.
- Your Grok login is never synced.
The rings
Up to four rings. One weekly pool.
Total is your whole pool. Grok, Grok Bot and Cursor are each one's share of pool, so the slices add up to the Total (14% + 27% + 1% = 42%). Each ring turns green, orange and red at levels you choose.
Total
Your whole SuperGrok weekly pool: everything below added up.
Grok
Regular Grok use (grok.com, the Grok apps, Imagine, Voice, the API): the Total minus Grok Bot and Cursor.
Grok Bot
Grok Bot's share of the pool when the two share one, or its own weekly allowance when it has one.
Cursor optional
Cursor's share of the pool, when xAI's usage data lists it. No Cursor sign-in needed.
How it works
Your login stays on your Mac.
GrokGauge uses the Grok CLI login already on your Mac. No new accounts, no passwords, no middleman.
- 1
Install
One Homebrew command installs GrokGauge and the Grok CLI. Or drag the app from GitHub Releases into Applications.
- 2
Sign in to the Grok CLI
Run
grok loginonce. GrokGauge reads that login from~/.grok/auth.jsonand keeps it renewed, just like the CLI does. - 3
Glance
Your usage appears in the menu bar and refreshes on its own every 5 to 60 minutes.
Privacy, in plain words
- Your Grok tokens never leave your Mac except to go to xAI's own servers over HTTPS, to fetch your usage and to renew your login. GrokGauge refuses to send them anywhere else.
- The Grok Bot number comes from a file the Grok Bot app saves on your Mac. GrokGauge makes no network requests for Grok Bot.
- Logins are never synced between Macs. Only settings and usage history (timestamps and percents) sync, and only to a folder you choose.
- No analytics, no telemetry, no account. Open source, so you can read every line.
Install
Up and running in a minute.
Recommended
Homebrew
brew install --cask stevencombs/tap/grokgauge
Also installs the Grok CLI (Homebrew's grok-build cask, downloaded from x.ai). Then run grok login once. Update later with brew upgrade --cask grokgauge.
Direct download
GitHub Releases
Download the zip from the latest release, unzip it and drag GrokGauge.app into Applications. Each release lists the zip's SHA-256.
Latest release →
Requirements
What you need
- macOS 14 Sonoma or later (Apple silicon or Intel)
- A SuperGrok subscription
- The Grok CLI, signed in once (needed for the Total and Grok rings; the Homebrew install includes it)
- Optional: the Grok Bot app, for the Grok Bot ring
- Optional: Homebrew, for the one-line install
No Homebrew, or prefer xAI's own installer? Install the Grok CLI with xAI's official installer, then sign in:
curl -fsSL https://x.ai/cli/install.sh | bash && grok login
Having both the Homebrew and installer copies is harmless; they share one login. GrokGauge offers the same steps in its dropdown. It never installs anything or signs in on its own.
FAQ
Questions, answered.
Is it official?
No. GrokGauge is an unofficial community project by Steven “retroCombs” Combs. It is not made, endorsed or supported by xAI or Cursor. It reads usage from unofficial endpoints that can change without notice, which could break it until it's updated.
Is it safe?
The code is open source under the MIT license, so anyone can read it. Your Grok tokens go only to xAI's own servers, over HTTPS. There's no analytics or telemetry, and logins never sync between Macs. As with any unofficial tool, use it at your own risk.
Why does macOS warn me before 1.0?
Releases before 1.0 aren't notarized by Apple yet, so a manually downloaded copy gets a Gatekeeper warning the first time you open it. Open System Settings › Privacy & Security and click Open Anyway. The Homebrew install clears that flag for GrokGauge only. Version 1.0 is planned to be signed and notarized by Apple, so the warning goes away.
What does it cost?
Nothing. GrokGauge is free. If it saves you from a surprise at the weekly limit, a tip is always appreciated.
Do I need Grok Bot or Cursor?
No. The Total and Grok rings only need the Grok CLI. The Grok Bot ring appears when the Grok Bot app is installed, and the Cursor ring is an optional setting.
I use several Macs. Does it keep up?
Yes. Choose a folder your Macs already sync (Google Drive, Dropbox, iCloud Drive and so on) and GrokGauge syncs your settings and usage history through it. Run grok login on each Mac, because logins are never synced. The Sync tab has one folder, one status line and a switch each for settings and history, and GrokGauge moves every Mac to the folder your other Macs use.
More apps from retroCombs
Part of the Gauge family.
Small, native menu bar apps for Mac, built in the open.
GrokGauge You are here
Your SuperGrok and Grok Bot weekly usage as colored rings in the menu bar, so the weekly limit never sneaks up on you.
ClipGauge
Local AI that renames and sorts your video and photo clips in place, with transcripts saved next to them.
Visit the ClipGauge page →
Free, and built in the open.
GrokGauge was made by Steven “retroCombs” Combs together with Grok Bot. If it saves you a surprise at the weekly limit, you can say thanks with a tip.