Codex Quota
Apps & Automationcodex-quotaCodex Quota is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/codex-quota/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/codex-quota, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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:
- Finds the most recent session file
- Extracts the last
rate_limitsobject - 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