Codex Rate Limits Plugin

codex-rate-limits-plugin is a standalone repository for the codex-rate-limits Codex plugin.

The plugin reports current Codex ChatGPT subscription rate-limit windows by querying the local codex app-server JSON-RPC API and formatting the 5h and Weekly windows for quick answers.

What this repo contains

• plugins/codex-rate-limits/ - the installable local plugin package.
• plugins/codex-rate-limits/skills/check-codex-rate-limits/ - the skill definition, helper script, and protocol reference.
• docs/ARCHITECTURE.md - the canonical runtime design, constraints, and compatibility notes.
• docs/DISTRIBUTION.md - the canonical packaging and rollout guidance.
• .agents/plugins/marketplace.json - a repo-local marketplace entry for plugin discovery during development.

Quickstart

Run the bundled helper directly:

python3 plugins/codex-rate-limits/skills/check-codex-rate-limits/scripts/read_rate_limits.py --utc

If you want JSON output:

python3 plugins/codex-rate-limits/skills/check-codex-rate-limits/scripts/read_rate_limits.py --json --utc

Validation

Run the repo validation entrypoints:

python3 scripts/quality.py ci
python3 scripts/quality.py local

Syntax-check the packaged helper:

python3 -m py_compile plugins/codex-rate-limits/skills/check-codex-rate-limits/scripts/read_rate_limits.py

Test the unsupported/no-auth path:

python3 scripts/quality.py local

For live authenticated validation and prompt-routing checks, use docs/TESTING.md.

Repository layout

• plugins/codex-rate-limits/.codex-plugin/plugin.json - local plugin manifest.
• plugins/codex-rate-limits/skills/check-codex-rate-limits/SKILL.md - skill definition for checking rate limits.
• plugins/codex-rate-limits/skills/check-codex-rate-limits/scripts/read_rate_limits.py - packaged helper that makes the JSON-RPC call.
• plugins/codex-rate-limits/skills/check-codex-rate-limits/references/app-server-contract.md - protocol reference for the local app-server API.