Awesome-openclaw-skills codex-quota

Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script.

install
source · Clone the upstream repo
git clone https://github.com/sundial-org/awesome-openclaw-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/codex-quota" ~/.claude/skills/sundial-org-awesome-openclaw-skills-codex-quota && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/codex-quota" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-codex-quota && rm -rf "$T"
manifest: skills/codex-quota/SKILL.md
source content

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