Usage Check
Inspect current Codex rate-limit windows without redeeming reset credits.
Workflow
- Run
scripts/show-codex-usage.sh. - If the sandbox blocks network access, rerun the same command with approval.
- Report the primary 5-hour and secondary weekly windows, including used and remaining percentages, reset time, limit status, plan type, and usage-credit balance.
- Route questions about banked reset-credit grants or expiry to
$usage:credits. - Never print access tokens, account IDs, user IDs, or email addresses.
Script modes
- Default: print a human-readable redacted summary.
--json: print redacted structured usage fields.--raw: print the exact endpoint response. Use only when necessary and do not repeat identifiers or other sensitive fields in the response.
The helper accepts CODEX_AUTH_FILE and CODEX_USAGE_URL. It sends Codex
credentials only to the default ChatGPT HTTPS host unless
CODEX_ALLOW_UNSAFE_ENDPOINT=1 is explicitly set for controlled testing.
Treat failures as possible internal-endpoint, authentication, account, or rollout changes rather than user error.