qdyanbing/codex-reset-checker

codex-reset-checker is a small command line tool with no external dependencies that checks how many rate limit resets are currently available for OpenAI's Codex tool. It works by reading the access token already stored locally in a file at ~/.codex/auth.json, the same credential Codex itself saves after you log in, and using it to call an internal ChatGPT backend endpoint that reports reset credits. The tool only prints information about the reset credits themselves: how many are available, each one's status, its title, when it was granted, and when it expires. It explicitly does not print the access token, any refresh token, cookies, or other identifying information, so running it should not expose your login credentials in the terminal output. The simplest way to use it is running npx codex-reset-checker directly, which prints a small table showing the count of available resets along with the status, expiry date, grant date, and title of each one, using your local timezone by default. From a local checkout of the project, the same command can be run as npx . A few flags extend this basic usage. Passing --json switches the output to machine readable JSON instead of the table. Passing --timezone lets you choose a specific timezone for the displayed dates rather than relying on the system default. Passing --auth-file lets you point the tool at a different credentials file if your Codex login is stored somewhere other than the default location. If the underlying API responds with a 401 error, the tool reports plainly that the credential has expired or that the authorization header was rejected, rather than failing with an unclear error.