name	codex-auto-reset
description	Install, inspect, authorize, dry-run, disarm, or remove the Codex Auto Reset watcher. Use when the user asks to automatically redeem one, a bounded number, or a continuous sequence of banked Codex usage resets after confirmed rate-limit exhaustion; manage the macOS background service; or inspect reset authorization status.

Codex Auto Reset

Use the bundled deterministic command wrapper:

<skill-dir>/scripts/manage <command>

Resolve <skill-dir> to this skill's directory. Do not rewrite or directly call Codex backend APIs.

Treat arm as account-level mutation authorization. Run it only after an explicit user request.
Keep plain arm --yes as the one-shot default for one exact currently available credit.
Use arm --count N --yes only when the user explicitly requests a bounded sequence of two or more. Explain that it remains active until N successful resets, disarm, or service removal. Treat --count 1 as the exact-credit one-shot.
Use arm --continuous --yes only when the user explicitly requests standing authorization. Explain that it automatically uses current and future reset credits until disarmed.
Never infer continuous authorization from words such as "automatic" or "auto-reset" alone.
Default redemption waits for backend-confirmed rate-limit exhaustion.
Never enable percentage-threshold redemption implicitly. Use it only after an explicit user request.
Never read Codex credential files or call private backend routes.
Run status before changing an existing authorization.

Install or update the watcher:

<skill-dir>/scripts/manage install-service
<skill-dir>/scripts/manage status

Preserve existing service settings by omitting options. For an explicitly requested percentage trigger:

<skill-dir>/scripts/manage install-service --usage-threshold-percent 95

Return to the backend-confirmed default only after explicit confirmation:

<skill-dir>/scripts/manage install-service --backend-only

Authorize one exact currently available reset after explicit confirmation:

<skill-dir>/scripts/manage status
<skill-dir>/scripts/manage arm --yes

Authorize a bounded sequence only when the user supplies the count:

<skill-dir>/scripts/manage status
<skill-dir>/scripts/manage arm --count <N> --yes

Authorize continuous redemption only after confirming that it persists until disarmed:

<skill-dir>/scripts/manage status
<skill-dir>/scripts/manage arm --continuous --yes

Inspect without consuming:

<skill-dir>/scripts/manage check --dry-run

Cancel any waiting, armed, settling, bounded, or continuous authorization before redemption commits:

<skill-dir>/scripts/manage disarm --yes

Remove the watcher only after explicit confirmation:

<skill-dir>/scripts/manage uninstall-service --yes

If state is redeeming, do not delete or disarm it. Let the idempotent retry finish, then inspect status again.

name	codex-auto-reset
description	Install, inspect, authorize, dry-run, disarm, or remove the Codex Auto Reset watcher. Use when the user asks to automatically redeem one, a bounded number, or a continuous sequence of banked Codex usage resets after confirmed rate-limit exhaustion; manage the macOS background service; or inspect reset authorization status.