codex_status
Verify that the codex CLI is installed and authenticated, and check live quota windows to decide whether to proceed with Codex calls.
Instructions
Check that the codex CLI is installed, authenticated, and a supported
version, and report the resolved defaults. Free — no model call. Run it before
your first paid call in a session to confirm setup, and again whenever a run
fails with a setup error.
Also reports a rate_limit block — how much of the Codex quota windows remains,
fetched LIVE from codex app-server (a read-only call with no model spend). primary
is the shorter/rolling window, secondary the longer one; the account reports only the
windows that currently bind it, so either may be null. Use it to decide whether to spend:
available is deliberately conservative (only when every reported window is healthy);
when limited/exhausted, prefer to defer non-urgent Codex calls (urgent ones may still
proceed); unknown means the live read couldn't complete just now (retry) or only a stale
cache was available; unavailable means this codex/account exposes no quota data — none
of these means anything is wrong.
is_stale/as_of show freshness; home_unverified flags a snapshot from a different
CODEX_HOME.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes |