Grok CLI meters a weekly usage pool. When it runs out mid-task you get a retry warning, and unless you were staring at the terminal you find out late. Three ways to stay ahead:
1. Inside the CLI
Grok CLI prints usage warnings as you approach limits, and the xAI console shows your plan and billing. Both are accurate; neither is ambient — you have to go look.
2. The xAI console
Your xAI account console is authoritative for plan, billing, and monthly spend. It does not show live session state on your machine.
3. A menu-bar companion with live session state
Agent Island (free, open source, MIT) reads the Grok CLI's local records: the weekly pool percentage with reset countdown, monthly spend, and — because Grok writes an explicit turn-completed event to its session log — a live working / stalled / your-turn state on the Mac menu bar. When a background Grok run finishes, the island tells you it is your turn. Nothing leaves your machine.
Download for macOS — an existing grok CLI login is all it needs.
FAQ
Can I get notified when a Grok CLI run finishes?
Yes. Grok CLI writes a turn-completed event to its local session log, and Agent Island turns that into a your-turn alert with an optional sound.
Where does the usage number come from?
From the same billing endpoint the CLI itself uses, read with your existing local login. Agent Island never sees your password.
Does this work with SuperGrok plans?
Yes. The plan badge shows whatever tier your login carries, including SuperGrok.
Agent Island is open source (MIT). See the changelog, the comparison hub, or the product FAQ.