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

24 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors