Agent skill

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.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/codex-quota

Metadata

Additional technical details for this skill

openclaw
{
    "requires": {
        "bins": [
            "python3",
            "codex"
        ]
    }
}

SKILL.md

Skill: codex-quota

Check OpenAI Codex CLI rate limit status.

Quick Reference

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

# Or if installed to PATH
codex-quota

Options

bash
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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results