Agent HUD · Guides · Supported clients
Grok CLI credits and quota on Mac
Grok CLI reports credit usage for the current period, plus a separate allowance for on-demand work.
At a glance
| Quota | Credit usage, on-demand row |
|---|---|
| Account | User · team, email label |
| Running · completion | Yes · Yes |
| Credentials read | CLI login record |
What you see
One row for credit usage in the current period — weekly or monthly, as the service says — and a second row for the on-demand cap and how much of it is used. The plan comes from your subscription tier.
How the account is named
The user and team from the login record, with the email as the label.
Running turns and completions
Both running turns and completions are detected.
What Agent HUD reads
The CLI's own credentials file, its session updates and its unified log. Browser cookies are never imported.
Common questions
- Why is my Grok login not read?
- A login whose principal is a team is rejected, and a notice says so. A personal login with an unexpired entry is read; an expired one is a sign-in notice.
- What is the second Grok row?
- The on-demand allowance, kept apart from the period's credit usage so that the two are never added together or mixed into one percentage.
Last updated: 2026-09-20 · The behaviour described here is documented in full, with the code it comes from, in Agent HUD Open. providers.md