# Codex Reset Credit

> Use when the user explicitly asks about Codex reset credits, credit expiry, quota usage, local rate-limit windows, or when Codex limits reset.

- Skill: `heynag/codex-reset-credit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add heynag/codex-reset-credit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heynag/codex-reset-credit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: heyNag (https://skillmd.com/u/heynag)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/heynag/codex-reset-credit

---


# 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:

```sh
python3 scripts/check_reset_credits.py
```

Useful options:

```sh
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:

1. Reset credits available
2. Next credit expiry, if known
3. Primary rate-limit reset window
4. Secondary rate-limit reset window, if present
5. Evidence boundary and any staleness warning
6. 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.