MarekBartczak

Gnome AI Usage — AI skill for Claude Code

AI community

Claude Code and Codex CLI usage limits (5h / weekly) on the GNOME top bar.

How to install Gnome AI Usage

This entry records only its repository, not the path inside it, so there is no exact command to give. Open MarekBartczak/gnome-ai-usage and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Gnome AI Usage does

Claude Code and Codex CLI usage limits (5h / weekly) on the GNOME top bar.

Alternatives in AI

Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★
Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★
Syrtis — AI token usage & quota monitor for the macOS menu bar — native Swift, Liquid Glass, 3D contribution graph 368 ★

README

gnome-ai-usage

Claude Code and Codex CLI usage limits on the GNOME top bar: the 5-hour session and the weekly limit, in percent, for every account you are logged into.

Work and personal profiles grouped on the top bar, with a separate icon color for each group:

![Top bar with Claude and Codex paired in work and personal groups](docs/screenshots/top-bar-groups.png)

The menu follows the same groups and colors. Expand an account for its limits, reset times, and top bar toggle:

![Grouped account menu with Claude Work expanded and personal accounts in purple](docs/screenshots/menu-groups.png)

Screenshots use example accounts.

Each account shows its 5-hour % (bright) and weekly % (dim). Yellow at 75 %, red at 90 %.
The menu shows every limit the API reports (including per-model weekly caps and extra usage) with time to reset.
"Show on top bar" picks which accounts sit on the bar. By default it shows the first Claude and the first Codex account.
Profiles that share a name (claude-work and codex-work) sit together in one frame on the bar and in one section of the menu. The first group keeps the panel color; the others tint their icons (purple, blue, green, teal). Settings → Top bar colors changes them.
Data refreshes every 5 minutes. "Refresh now" updates it immediately.

Choose a custom icon color for each group in the extension preferences, or reset it to the automatic color:

![Extension preferences with color controls for work and personal groups](docs/screenshots/preferences-colors.png)

Install (Ubuntu / Debian, GNOME 45+)

wget https://github.com/MarekBartczak/gnome-ai-usage/releases/latest/download/gnome-ai-usage.deb
sudo apt install ./gnome-ai-usage.deb
ai-usage setup

Updates

Installing the package also adds its APT repository (`/etc/apt/sources.list.d/gnome-ai-usage.sources`, signed with the key in `/usr/share/keyrings/`). New versions then arrive like any other Ubuntu update: