Codex Quota

Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script. Reads ~/.codex/sessions/ for quota data. When using --all --yes, it temporarily switches accounts by overwriting ~/.codex/auth.json (restored afterwards) to query each account. Uses the `codex` CLI for --fresh / --all.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install codex-quota

Skill: codex-quota

Check OpenAI Codex CLI rate limit status.

Quick Reference

# Run the included Python script
./codex-quota.py

# Or if installed to PATH
codex-quota

Options

codex-quota              # Show current quota (cached from latest session)
codex-quota --fresh      # Ping Codex first for live data
codex-quota --all --yes  # Update all accounts, save to /tmp/codex-quota-all.json
codex-quota --json       # Output as JSON
codex-quota --help       # Show help

Setup

See SETUP.md for prerequisites and setup instructions.

What It Shows

Primary Window (5 hours) — Short-term rate limit
Secondary Window (7 days) — Weekly rate limit
Reset times in local timezone with countdown
Source session file and age

When to Use

Before starting heavy Codex work (check weekly quota)
When Codex seems slow (might be rate-limited)
Monitoring quota across multiple accounts