Skip to content

ayv4zyan/codex-reset-dates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex Reset Dates

Tiny Node.js CLI that prints your banked Codex reset credit expiry dates.

It reads your existing local Codex Desktop login from ~/.codex/auth.json, calls the Codex reset-credit endpoint, and prints each available reset date in your local timezone.

./codex-reset-dates.js

Example output:

Reset 1: Sun, Jul 12, 2026, 9:08 AM GMT+4
Reset 2: Sat, Jul 18, 2026, 4:55 AM GMT+4
Reset 3: Mon, Jul 27, 2026, 4:08 AM GMT+4

Why

Codex can show banked reset credits, but sometimes you just want the reset expiry dates in a terminal. This script extracts only that logic from a larger macOS menu bar app workflow and keeps it as a dependency-free Node.js command.

Useful searches this project is meant to answer:

  • Codex reset date
  • Codex banked reset credits
  • Codex reset credit expiry
  • Codex rate limit reset
  • ChatGPT Codex reset credits
  • Codex Desktop auth reset watcher

Requirements

  • Node.js 18 or newer
  • Codex Desktop installed and signed in
  • A local Codex auth file at ~/.codex/auth.json

No OpenAI API key is required.

Usage

Clone and run:

git clone https://github.com/ayv4zyan/codex-reset-dates.git
cd codex-reset-dates
./codex-reset-dates.js

Or run with Node:

node codex-reset-dates.js

If your Codex home directory is not ~/.codex, set CODEX_HOME:

CODEX_HOME=/path/to/.codex ./codex-reset-dates.js

What It Calls

GET https://chatgpt.com/backend-api/wham/rate-limit-reset-credits

The request uses the saved Codex Desktop bearer token from auth.json and, when available, the active ChatGPT-Account-Id.

This is a read-only check. It does not redeem reset credits, reset usage, modify your account, or store tokens.

Privacy

The script reads ~/.codex/auth.json locally and sends the bearer token only to chatgpt.com for the reset-credit request.

It does not print or save:

  • bearer tokens
  • refresh tokens
  • ID tokens
  • raw auth JSON
  • raw endpoint responses
  • reset credit IDs

Notes

This uses an internal Codex Desktop endpoint. It can change without notice.

Inspired by the reset-credit logic in jordan-edai/codex-reset-watcher.

License

MIT

About

Tiny Node.js CLI that prints banked Codex reset credit expiry dates from local Codex Desktop auth.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors