Codex Usage Reset

Codex Usage Reset is a Codex skill for checking local Codex ChatGPT usage windows and reset-credit expiry times.

It reads local Codex credentials, queries read-only account/usage data, and prints a sanitized summary that an agent can relay to the user.

What It Reports

• Current 5-hour and weekly usage windows, when available
• Reset time for each usage window
• Available reset-credit count
• Expiry time for each available reset credit, when the endpoint returns expiry rows
• Warnings when the internal endpoint or fallback path cannot provide complete data

Install

Copy the skill folder into your Codex skills directory:

$target = Join-Path $env:USERPROFILE ".codex\skills\codex-usage-reset"
Copy-Item -Recurse -Force ".\codex-usage-reset" $target

If you use CODEX_HOME, copy it under $env:CODEX_HOME\skills\codex-usage-reset instead.

Use

Ask Codex something like:

帮我查询 codex 重置的到期时间

The skill runs:

python "$env:USERPROFILE\.codex\skills\codex-usage-reset\scripts\check_codex_usage_reset.py"

You can also run the script directly:

python ".\codex-usage-reset\scripts\check_codex_usage_reset.py"
python ".\codex-usage-reset\scripts\check_codex_usage_reset.py" --json

Safety

This project is read-only. It must not consume, redeem, or reset any Codex rate-limit credits.

The script intentionally avoids printing bearer tokens, raw auth.json, full account IDs, reset-credit IDs, or raw endpoint JSON. See SECURITY.md and codex-usage-reset/references/safety-boundary.md before changing endpoint or credential-handling code.

Repository Layout

codex-usage-reset/
  SKILL.md
  agents/openai.yaml
  references/safety-boundary.md
  scripts/check_codex_usage_reset.py

Repository-level files such as this README and the license are intentionally kept outside the installable skill folder.

License

MIT License. See LICENSE.