codex-quota – OpenClaw Skill

---

name: codex-quota description: Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script.

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        # Update all accounts, save to /tmp/codex-quota-all.json
codex-quota --json       # Output as JSON
codex-quota --help       # Show help

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

Installation

Copy codex-quota.py to your path:

cp skills/codex-quota/codex-quota.py ~/bin/codex-quota
chmod +x ~/bin/codex-quota

How It Works

Codex CLI logs rate limit info in every session file (~/.codex/sessions/YYYY/MM/DD/*.jsonl) as part of token_count events. This tool:

1. Finds the most recent session file
2. Extracts the last rate_limits object
3. Formats and displays it

When to Use

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

codex-quota

A portable Python tool to check OpenAI Codex rate limit status.

Installation

cp codex-quota.py ~/bin/codex-quota
chmod +x ~/bin/codex-quota

Usage

codex-quota              # Cached data from latest session
codex-quota --fresh      # Ping Codex for live data
codex-quota --json       # JSON output

Example Output

═══════════════════════════════════════════
           CODEX RATE LIMIT STATUS         
═══════════════════════════════════════════

📊 Primary (5 hours window)
   [░░░░░░░░░░░░░░░░░░░░] 0.0%
   Resets: 2026-01-10 19:20 (in 4h 23m)

📈 Secondary (7 days window)
   [█████████████████░░░] 89.0%
   Resets: 2026-01-14 14:14 (in 95h 18m)

═══════════════════════════════════════════
   Updated: 2026-01-10 14:20
═══════════════════════════════════════════

How It Works

Reads rate limit data from Codex session files (~/.codex/sessions/). Every Codex API response includes rate limit headers, which get logged as token_count events in the session JSONL files.

License

MIT