What is codex-reset-monitor?

Codex Reset Monitor is a small tool that watches your usage limits for OpenAI's Codex coding assistant and emails you the moment something in your favor changes, such as your usage limit resetting or a free bonus credit showing up unexpectedly. Normally you would only find out about these changes by checking manually, and this tool automates that watching for you. It works by checking your account status every five minutes using the Codex command line tool you already have installed and signed in, reading the same information the Codex app shows when you type slash status. It saves a snapshot of your usage numbers, credit balance, and reset timestamps to a local file, then compares each new check to the last one. If your usage window resets, if your credit balance goes up, or if a new bonus credit becomes available, it sends you an email. It is designed to only notify you about good changes, so it will not spam you every time you simply use up some of your own quota. The tool is written in Python with no extra packages required, and does not store or copy your login token anywhere, since all authentication stays with the already installed Codex command line tool. Setup involves cloning the repository, running an install script that sets up a background scheduled task using systemd, and configuring an email account, most commonly Gmail using a special app password rather than your normal password. There is also optional support for sending alerts through WhatsApp instead of or alongside email, though that requires a Meta developer account and an approved message template. It currently only supports Linux systems that use systemd, since it relies on systemd's user timer feature to run its checks on a schedule and to keep running after a reboot. The README includes a troubleshooting section covering common issues like an expired login or a rejected email password.