- Displays current 5-hour session and weekly Codex usage.
- Shows a weekly usage trend and predicts whether limits will be hit before reset.
- Shows and redeems available banked resets.
- Can automatically apply a banked reset within one hour of expiry.
- ChatGPT desktop app or Codex CLI, signed in with your ChatGPT account on the same machine
- GNOME Shell 45+
Install the latest stable release with the installer script directly:
curl -fsSL https://raw.githubusercontent.com/slobbe/codex-meter/main/scripts/install.sh | shRun the script again to update.
- Download the latest release zip.
- Install and enable the extension with:
gnome-extensions install --force codex-meter@slobbe.github.io-<version>.zip
gnome-extensions enable codex-meter@slobbe.github.ioIf GNOME does not pick it up immediately, log out and back in.
To uninstall:
gnome-extensions uninstall codex-meter@slobbe.github.io- Extension not showing: check that it is enabled in the Extensions app, then log out and back in.
- Usage not loading or authentication expired: sign back in through the ChatGPT desktop app or Codex CLI, and check your internet connection.
- Still stuck: open an issue with your GNOME Shell version and the error message. Never share your auth file or tokens.
Codex Meter relies on ChatGPT backend endpoints, so upstream changes may temporarily affect functionality.
Codex Meter reads credentials from ~/.codex/auth.json to request usage and banked reset data from ChatGPT. It does not store credentials or send them anywhere else.
Usage data is cached locally in ~/.cache/codex-meter and ~/.local/state/codex-meter, with history kept for roughly 21 days (up to 25,000 entries).
Not affiliated with or endorsed by OpenAI.