- 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 [email protected]<version>.zip
gnome-extensions enable [email protected]If GNOME does not pick it up immediately, log out and back in.
For local development, run the following commands:
make install
gnome-extensions disable [email protected]
gnome-extensions enable [email protected]You may need to log out and back in to see the changes.
To build a release bundle locally:
make clean pack