codex-reset-credit
Use this skill only when a user explicitly asks about Codex reset credits,
available reset credits, reset-credit expiry, Codex quota usage, local
rate-limit windows, or when Codex limits reset.
This skill is read-only. It must not redeem or consume credits, change Codex
settings or usage-limit state, or modify auth/session files.
Operating Rules
- Run the helper script from this skill directory.
- Never print access tokens, refresh tokens, account IDs, credit IDs, email
addresses, profile image URLs, or raw auth file contents.
- Do not show auth file paths. If a local file path is needed for debugging,
ask first and prefer redacted paths.
- Prefer the direct answer first: available reset credits, next reset-credit
expiry, and local rate-limit reset windows.
- State the evidence boundary:
- reset credits come from the live Codex/ChatGPT backend endpoint
- rate-limit windows come from local Codex session
token_count snapshots
- local snapshots can be stale if Codex has not emitted recent token-count
events
- If auth/session state is missing or the endpoint fails, report the plain
safe error and any local-only rate-limit data that was still available.
Invocation
From this skill directory:
python3 scripts/check_reset_credits.py
Useful options:
python3 scripts/check_reset_credits.py --json
python3 scripts/check_reset_credits.py --no-live
python3 scripts/check_reset_credits.py --thread-id THREAD_ID
python3 scripts/check_reset_credits.py --session-file /absolute/path/to/rollout.jsonl
python3 scripts/check_reset_credits.py --timezone America/Los_Angeles
Use --no-live when the user only wants local rate-limit reset windows or when
network/backend access is not appropriate. Use --json when another tool or
agent needs structured sanitized output.
Response Shape
Unless the user asks for raw JSON, return:
- Reset credits available
- Next credit expiry, if known
- Primary rate-limit reset window
- Secondary rate-limit reset window, if present
- Evidence boundary and any staleness warning
- Safe error details, if any
Keep the answer short. Do not paste full JSON unless requested.
Failure Handling
- Missing Codex auth: say local Codex auth was not found or not usable.
- Endpoint error: say the live reset-credit endpoint failed and include the
safe HTTP/network category.
- Missing session snapshots: say no local Codex rate-limit snapshots were found.
- In all cases, do not reveal tokens, account IDs, auth file contents, or raw
local auth paths.
1---2name: codex-reset-credit3description: Use when the user explicitly asks about Codex reset credits, credit expiry, quota usage, local rate-limit windows, or when Codex limits reset.4license: MIT5---67# codex-reset-credit89Use this skill only when a user explicitly asks about Codex reset credits,10available reset credits, reset-credit expiry, Codex quota usage, local11rate-limit windows, or when Codex limits reset.1213This skill is read-only. It must not redeem or consume credits, change Codex14settings or usage-limit state, or modify auth/session files.1516## Operating Rules1718- Run the helper script from this skill directory.19- Never print access tokens, refresh tokens, account IDs, credit IDs, email20 addresses, profile image URLs, or raw auth file contents.21- Do not show auth file paths. If a local file path is needed for debugging,22 ask first and prefer redacted paths.23- Prefer the direct answer first: available reset credits, next reset-credit24 expiry, and local rate-limit reset windows.25- State the evidence boundary:26 - reset credits come from the live Codex/ChatGPT backend endpoint27 - rate-limit windows come from local Codex session `token_count` snapshots28 - local snapshots can be stale if Codex has not emitted recent token-count29 events30- If auth/session state is missing or the endpoint fails, report the plain31 safe error and any local-only rate-limit data that was still available.3233## Invocation3435From this skill directory:3637```sh38python3 scripts/check_reset_credits.py39```4041Useful options:4243```sh44python3 scripts/check_reset_credits.py --json45python3 scripts/check_reset_credits.py --no-live46python3 scripts/check_reset_credits.py --thread-id THREAD_ID47python3 scripts/check_reset_credits.py --session-file /absolute/path/to/rollout.jsonl48python3 scripts/check_reset_credits.py --timezone America/Los_Angeles49```5051Use `--no-live` when the user only wants local rate-limit reset windows or when52network/backend access is not appropriate. Use `--json` when another tool or53agent needs structured sanitized output.5455## Response Shape5657Unless the user asks for raw JSON, return:58591. Reset credits available602. Next credit expiry, if known613. Primary rate-limit reset window624. Secondary rate-limit reset window, if present635. Evidence boundary and any staleness warning646. Safe error details, if any6566Keep the answer short. Do not paste full JSON unless requested.6768## Failure Handling6970- Missing Codex auth: say local Codex auth was not found or not usable.71- Endpoint error: say the live reset-credit endpoint failed and include the72 safe HTTP/network category.73- Missing session snapshots: say no local Codex rate-limit snapshots were found.74- In all cases, do not reveal tokens, account IDs, auth file contents, or raw75 local auth paths.
heyNag