Agent skill · software engineering · sundial-org

codex-quota

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

Why this skill is useful

Adds a portable Python script that checks OpenAI Codex CLI rate limits, providing specific commands and session log parsing that the AI wouldn't reliably generate on its own.

What it needs

Requires python installed locally. Requires openai account access. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.

What this skill does

Skill: codex-quota Check OpenAI Codex CLI rate limit status. Quick Reference Options 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: How It Works Codex CLI logs rate limit info in every session file (~/.codex/sessions/YYYY/MM/DD/.jsonl) as part of tokencount events. This tool: 1. Finds the most recent session file 2. Extracts the last ratelimits 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

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sundial-org/codex-quota

View the source on GitHub

Browse the @skills marketplace