A GNOME Shell extension to monitor AI provider usage metrics directly from the system panel. This extension acts as a graphical interface for the CodexBar CLI, providing real-time visibility into your API quotas and usage tiers.
- Real-time monitoring of AI provider usage (Gemini, OpenAI, etc).
- Support for multiple usage tiers (Primary, Secondary, Tertiary).
- Toggle between Remaining Quota and Used Quota display modes.
- Automatic background refreshes with configurable intervals.
- Visual warnings (color changes) when reaching quota limits.
- Automatic resolution of CodexBar CLI paths (Homebrew supported).
The extension requires the CodexBar CLI tool installed on your system.
It is recommended to install the CLI via Homebrew:
brew install steipete/tap/codexbarEnsure you have configured your providers and API keys in the CLI before using the extension.
- Clone this repository or download the source code.
- Run the provided installation script:
./install.sh
- Restart GNOME Shell:
- On X11: Press
Alt+F2, typer, and pressEnter. - On Wayland: Log out and log back in.
- On X11: Press
- Enable the extension using GNOME Extensions or via command line:
gnome-extensions enable codexbar@inled.es
Access the settings through the gear icon in the extension menu.
Each provider must be configured with a command that returns JSON output. Example for Gemini:
codexbar --provider gemini --source api --format jsonThe extension will automatically attempt to locate the codexbar binary in common locations such as /home/linuxbrew/.linuxbrew/bin/ if an absolute path is not provided.
You can choose how metrics are displayed:
- Remaining: Shows the percentage of quota left (default).
- Used: Shows the percentage of quota consumed.
Detailed setup guides and troubleshooting information can be found at help.inled.es/codexbar-gnome.
This project is licensed under the terms of the MIT-INLED license. Contributions are welcome!