codex-reset-checker is a small Codex skill for checking available Codex reset credits and their expiration dates from the existing local Codex Desktop login.
It is intentionally narrow: it prints a concise reset-credit countdown like this:
• Checked: 2026-07-04 18:17:21 +08:00
Available resets: 4
2026-07-12 09:35:51 +08:00 - in 7d 15h
2026-07-18 08:32:15 +08:00 - in 13d 14h
2026-07-27 07:46:29 +08:00 - in 22d 13h
2026-08-01 03:56:30 +08:00 - in 27d 9h
No available reset is already expired.
This skill is adapted from the endpoint/auth pattern documented and implemented by Jordan Wilson in jordan-edai/codex-reset-watcher, an MIT-licensed local-first macOS utility for Codex usage limits and reset credits.
The original project documents that Codex reset-credit data currently comes from:
GET https://chatgpt.com/backend-api/wham/rate-limit-reset-credits
using the existing local Codex Desktop auth file. See NOTICE.md for the original MIT notice.
Copy this folder into your Codex skills directory:
mkdir -p ~/.codex/skills
rsync -a ./ ~/.codex/skills/codex-reset-checker/Then invoke the skill in Codex:
Use $codex-reset-checker to show my available Codex resets and expiration dates.
python3 scripts/codex_reset_checker.pyUseful options:
python3 scripts/codex_reset_checker.py --tz America/Chicago
python3 scripts/codex_reset_checker.py --self-test
python3 scripts/codex_reset_checker.py --auth /path/to/auth.json- Reads
${CODEX_HOME:-~/.codex}/auth.json. - Sends the existing bearer token to the reset-credit endpoint.
- Sends
ChatGPT-Account-Idwhen it can be derived from local Codex auth. - Does not print tokens or raw auth JSON.
- Does not redeem resets, reset usage, mutate account state, store snapshots, or send analytics.
- Unofficial and not affiliated with OpenAI.
- Uses an internal Codex Desktop endpoint that can change without notice.
- Requires Codex Desktop to be installed and signed in locally.
- Reset-credit fields may differ by account, plan, region, or Codex Desktop version.
MIT. See LICENSE.