SkillFoxx

codex-reset-checker CLI

A CLI that shows Codex usage limits and the number of manual resets, and spends one reset after explicit confirmation.

  • 87 ★ on the repository
  • Last commit
  • MIT
CLI

Broad access

Why this level

  • The utility reads the Codex login token and sends it to a private backend, and the `--reset` flag irreversibly spends a manual reset.
All reasons and checks

doggy8088/codex-reset-checkerAuthor:doggy8088

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add cli/codex-reset-checker

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The utility reads the Codex login token and sends it to a private backend, and the `--reset` flag irreversibly spends a manual reset.

This is third-party code. Review the repository files before installing.

What it does

The `codex-reset-checker` utility reads the local Codex login file `auth.json`, calls the ChatGPT backend and prints two sets of data. First, the used and remaining share of the current session and weekly window limits, plus per-model limits when present, with a countdown to reset. Second, the number of available manual resets with the acquisition time and expiry of each. By default it only reads: files stay unchanged and `access_token` and `account_id` are never printed. The `--json` flag gives data for scripts, `--watch` refreshes the screen every minute and `--reset` spends one manual reset after a confirmation phrase is typed. A retry key guards repeats.

Who it is for. Codex subscribers who want to see remaining limits in the terminal and decide when to spend a manual reset.

Good fit when

  • Before a long task you need to know how much is left in the weekly window.
  • A script or status bar reads the remaining limits as JSON.
  • The session limit is exhausted and the user decides to spend a manual reset.
  • The balance is watched in a separate terminal window refreshed every minute.

Not a fit when

  • Codex is signed in with an API key: there is no subscription token file.
  • You do not want to hand your account token to a third-party utility.
  • An official stable interface is required: the utility relies on a private backend.

Example request

Show the remaining Codex limits as JSON and the number of available manual resets, but spend nothing.

Limitations

The utility takes the token from the local `auth.json` and sends it to the ChatGPT server, so it deserves the same trust as the client itself. The backend is private and undocumented: the response format may change and the output would break. A manual reset cannot be undone and after a timeout the outcome may be unclear, so the operation must be repeated with the same identifier. The `--force` flag removes the confirmation prompt. Unofficial access may displease the service provider.

How to disable. Remove the package with `npm uninstall -g @willh/codex-reset-checker`. The utility does not change `auth.json`, so no extra cleanup is needed.

FAQ

How do I run it without installing?

Run `npx @willh/codex-reset-checker`. For regular use install it globally with `npm install -g @willh/codex-reset-checker`.

Does it change anything by default?

No. Without `--reset` it only reads data and writes nothing to files.

How do I spend a manual reset?

Run `codex-reset-checker --reset` and type the confirmation phrase. The `--force` key skips the question.

How do I point to another login file?

Pass the path as an argument: `codex-reset-checker --auth /path/to/auth.json`.

What if a reset hangs on a timeout?

The utility shows the operation identifier. Repeat the command as `--reset=<uuid>` so a second reset is not spent.

Discussion

No questions or reviews yet.

CLI tools

A Codex skill for safe local-state maintenance: a report-only default, backup and archive instead of deletion, log and worktree cleanup

SkillExtended access1.6K

A plugin and MCP tools show where Codex tokens, time, credits and money go, based on local session metadata.

PluginExtended access196

A limits and token spend monitor for Claude Code, Codex, Antigravity and Grok CLI: macOS menu bar, Windows tray, HTML reports

CLIExtended access347
Editors’ pick

Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session

CLIExtended access19.4K

A Claude Code usage reset tracker over MCP: the agent says how many days have passed since the last reset and pulls the archive with links to posts

MCP serverExtended access

A utility that brings back Codex threads lost after a provider switch by syncing sessions and SQLite and making backups.

CLIExtended access106

README in short

The README covers purpose, repository layout, installation, command-line flags, output format, error handling, time conversion and security rules.

README badge

Report a problem