cxreset is an unofficial, read-only CLI that shows your current Codex usage limits, banked Full resets, their expiration times, and an estimate of how valuable a reset would be right now.

npm install --global @dompish/cxreset

Node.js 18 or newer is required.

Sign in through Codex first:

codex login
cxreset

Example:

Codex usage
  5-hour       31% used · 69% left · resets 2026-07-01 22:26 GMT+8
  Weekly       44% used · 56% left · resets 2026-07-07 12:19 GMT+8

Full resets
  Available    2
  #1 expires   2026-07-18 08:15 GMT+8
  #2 expires   2026-07-27 07:49 GMT+8

Reset value    2.7/10 · Moderate

Times use the local timezone of the machine running the command. Available resets are ordered by expiration time.

The only additional command-line options are:

cxreset --help
cxreset --version

The score estimates the potential value of using a Full reset. It considers both how much of each limit has been used and how long remains until that limit resets naturally:

window value = used ratio × remaining time / window duration
score = 10 × (5-hour value × 40% + weekly value × 60%)

The weekly limit receives more weight because it replenishes more slowly. The score is clamped to 0–10 and rounded to at most one decimal place.

This is a heuristic, not a recommendation or a guarantee of future capacity.

cxreset reads the existing ChatGPT login from $CODEX_HOME/auth.json or ~/.codex/auth.json. It does not print, refresh, or write credentials. It only makes read-only requests and cannot consume a reset. There is no telemetry.

The Codex usage and reset-credit routes used by this package are internal, undocumented service endpoints and may change without notice.

npm install
npm run typecheck
npm test
npm run pack:check

The package has no runtime dependencies.

MIT