Codex usage status (quota + pace)

Quick start

Run the bundled CLI script (it reads credentials implicitly via openclaw status --usage --json, so no API keys are needed):

python3 scripts/codex_usage_status.py
# or
./scripts/codex_usage_status.py

Common options:

./scripts/codex_usage_status.py --provider openai-codex
./scripts/codex_usage_status.py --json

What the script reports

• Provider plan name (when available)
• Usage windows (example labels: 5h, Day, Week) with:
  • Used %
  • Reset time (UTC) + time remaining
  • Pace projection

Pace definition

Pace is a simple end-of-week projection computed from the provider’s Day window usage percent.

The week window is anchored to the Day window reset time:

• week_end = Day.resetAt
• week_start = week_end - 7 days

Formula:

• Basis: Day.usedPercent (different label, same signal)
• Usage rate: current_used_percent ÷ time_elapsed_since_week_start
• Projection: current% + (rate × time_remaining_in_week)

If Day.usedPercent is missing or 0%, Pace is 0%.