- Displays current 5-hour session and weekly Codex usage.
- Predicts whether current usage trends will hit the session or weekly limit before reset.
- Show percentages as usage consumed or capacity left.
- Choose between raw percentages or progress bars in the panel indicator.
Note
Requires the Codex CLI and an active login on the same machine.
The extension reads your local local auth credentials from ~/.codex/auth.json to fetch usage data from https://chatgpt.com/backend-api/wham/usage.
- 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.
For local development, run the following commands:
make install
gnome-extensions disable codex-meter@slobbe.github.io
gnome-extensions enable codex-meter@slobbe.github.ioYou may need to log out and back in to see the changes.
To build a release bundle locally:
make clean pack