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.
Downloads
2.4k
Stars
2
Versions
8
Updated
2026-02-23
Install
npx clawhub@latest install codex-quota
Documentation
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](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
Launch an agent with Codex Quota on Termo.