Check AI subscription usage (Claude, Codex, Gemini, Antigravity) from the terminal using fuelcheck. Use when the user asks about rate limits, usage, remaining quota, fuel, credits, how much they've used, or wants to check their AI subscription status.
Check AI subscription usage across Claude, Codex, Gemini, and Antigravity from the terminal.
Before running any fuelcheck command, verify it's installed:
command -v fuelcheck
If NOT found, tell the user:
fuelcheck is not installed. Install it with:
curl -fsSL https://github.com/emanuelarcos/fuelcheck/releases/latest/download/install.sh | shOr if you have Go:
go install github.com/emanuelarcos/fuelcheck/cmd/fuelcheck@latest
Then STOP — do not proceed until the user installs it.
fuelcheck --json
Parse the JSON output to give the user a clear summary of their usage across all providers.
fuelcheck claude --json
fuelcheck codex --json
fuelcheck gemini --json
fuelcheck antigravity --json
fuelcheck claude codex --json # multiple providers
The JSON output contains per-provider results. Key fields:
five_hour and weekly usage windows with utilization percentagefive_hour and weekly usage windows with utilization percentageWhen reporting to the user:
| Provider | Requirement |
|---|---|
| Claude | Logged into Claude Code |
| Codex | Logged into Codex CLI |
| Gemini | Logged into Gemini CLI |
| Antigravity | Desktop app must be running |
If a provider fails, mention the prerequisite so the user knows how to fix it.
Always pass --json when running fuelcheck so you can parse structured output. The terminal UI mode is for human eyes only — you cannot parse lipgloss-styled cards.