Codex Usage Indicator GNOME Extension

Monitor your Codex usage directly from the GNOME top bar.

Inspired by CodexBar by Peter Steinberger, adapted for GNOME.

Features

• Displays current 5-hour and weekly Codex usage
• Shows 5-hour usage, weekly usage, or both in the top bar
• Choose between raw percentages, progress bars, or unified combined-pressure bar
• Supports manual refresh and configurable background refresh intervals

Install

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.

1. Download the latest release zip.
2. Install and enable the extension with:

gnome-extensions install codex-usage@slobbe.github.io-<version>.zip --force
gnome-extensions enable codex-usage@slobbe.github.io

If GNOME does not pick it up immediately, log out and back in.

Development / Build

For local development, install the extension into your user extensions directory:

mkdir -p ~/.local/share/gnome-shell/extensions/codex-usage@slobbe.github.io
rsync -a --delete ./ ~/.local/share/gnome-shell/extensions/codex-usage@slobbe.github.io/
glib-compile-schemas schemas
gnome-extensions disable codex-usage@slobbe.github.io
gnome-extensions enable codex-usage@slobbe.github.io

To build a release bundle locally:

./build-release.sh

This writes the packaged extension zip to dist/.

License

GPL-3.0-or-later