← Back to Skills Marketplace
Codex Quota
by
Oliver Drobnik
· GitHub ↗
· v1.2.2
6705
Downloads
3
Stars
19
Active Installs
9
Versions
Install in OpenClaw
/install codex-quota
Description
Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script. Reads ~/.codex/sessions/ for quota data. Whe...
Usage Guidance
Install only if you are comfortable with a tool reading Codex session logs and, when run with --all --yes, temporarily switching Codex accounts by rewriting ~/.codex/auth.json. Avoid --all --yes while other Codex processes are running, keep a backup of auth.json, and treat /tmp/codex-quota-all.json as sensitive account metadata that should be deleted or moved to a private directory after use.
Capability Analysis
Type: OpenClaw Skill
Name: codex-quota
Version: 1.2.2
The `codex-quota.py` script is classified as suspicious due to its high-risk manipulation of sensitive authentication files. Specifically, the `update_all_accounts` function temporarily overwrites `~/.codex/auth.json` (which likely contains API keys/tokens) to switch between different Codex accounts. Although the script attempts to restore the original `auth.json` and explicitly declares this behavior in `SKILL.md` and `SETUP.md`, a crash or interruption during this process could leave the authentication file in an unintended state, potentially leading to unauthorized access to a different account or a broken configuration. There is no evidence of intentional data exfiltration, persistence, or other malicious activities.
Capability Assessment
Purpose & Capability
The stated purpose, checking Codex CLI quota usage from local session logs, matches the main behavior. The multi-account feature is also purpose-aligned, but it requires sensitive access to Codex account/session files.
Instruction Scope
The docs disclose reading ~/.codex/sessions/, using the codex CLI, and overwriting ~/.codex/auth.json for --all --yes, but the risk is not prominent enough for a credential-state mutation and the CLI help only partially explains the side effect.
Install Mechanism
No hidden installer, package dependency chain, daemon, or startup hook was evident; setup is a portable Python script with optional PATH copying and expected python3/codex prerequisites.
Credentials
Reading local Codex logs is proportionate, but --all --yes overwrites ~/.codex/auth.json and writes aggregated account quota data to /tmp/codex-quota-all.json, which is weaker containment for sensitive local metadata.
Persistence & Privilege
There is no durable persistence or privilege escalation, but auth.json restoration is best-effort rather than protected by robust atomic/finally cleanup, so interruption could leave the active Codex account changed.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install codex-quota - After installation, invoke the skill by name or use
/codex-quota - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
fix: use /Users/oliver/clawd for workspace root to preserve symlink paths
v1.2.1
Rename .clawdhubignore to .clawhubignore
v1.2.0
Refactor: move setup/prerequisites to SETUP.md, keep SKILL.md lean
v1.1.3
Declare codex dependency and auth.json switching; restore auth.json bytes after --all.
v1.1.2
Require --yes for --all; clarify ~/.codex file access; OpenClaw metadata.
v1.1.1
- Added version number and metadata (including system requirements) to SKILL.md.
- Updated usage instructions: account switching with --all now requires the --yes flag.
- Improved description and documentation for clarity, including details about config and data file locations.
v1.1.0
Add --all to update all accounts, fix list_accounts to ignore cache files
v1.0.1
Added description metadata
v1.0.0
Initial release: Check OpenAI Codex rate limits via Python or Swift
Metadata
Frequently Asked Questions
What is Codex Quota?
Check OpenAI Codex CLI rate limit status (daily/weekly quotas) using local session logs. Portable Python script. Reads ~/.codex/sessions/ for quota data. Whe... It is an AI Agent Skill for Claude Code / OpenClaw, with 6705 downloads so far.
How do I install Codex Quota?
Run "/install codex-quota" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Codex Quota free?
Yes, Codex Quota is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Codex Quota support?
Codex Quota is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Codex Quota?
It is built and maintained by Oliver Drobnik (@odrobnik); the current version is v1.2.2.
More Skills