Omarchy Agent Meter — AI skill for Claude Code

Agent Meter

An [Omarchy](https://omarchy.org) bar widget showing how much of your AI coding limit you've used: a progress meter with the percentage inside it.


Built on Omarchy's own **Agents** widget. Clicking still opens the same full panel: every limit with its reset countdown, tokens by day, and tokens by model. The bar shows the number at a glance, so you don't have to open it.

**GuideCoded** by [JasonAdamHD](https://github.com/JasonAdamHD) and Claude. Jason directed the idea and the look; Claude wrote the code in Claude Code.

Features

• Meter with the number inside. The fill carries an inverted copy of the label, so the digits stay readable as the fill passes under them.
• Shows your current session by default. That's the rolling 5-hour window, the one that decides whether your next prompt goes through right now. You can switch it to the weekly limit, or to whichever window is fullest.
• Warns you. At 90% the meter switches to your theme's urgent color.
• Hover for detail, e.g. Claude Code · Session 12% · resets in 3h 40m.
• Follows your theme and hot-reloads like any Omarchy shell plugin.
• Works with every agent Omarchy tracks: Claude Code, Codex, and Fireworks. Middle-click switches between them. Agents without rate limits, and vertical bars, fall back to the regular icon.

Requirements

• Omarchy with the Quickshell-based shell and its built-in Agents widget, which provides the plugin system and the omarchy-agent-usage-update collectors this widget reads from. Tested on Omarchy 4.0.3.
• At least one agent that Omarchy can see: a signed-in Claude Code CLI, Codex, or a Fireworks account. See Where the numbers come from.

Install

There is nothing to build or compile. The widget is plain QML that the Omarchy shell loads directly.

omarchy plugin add https://github.com/JasonAdamHD/omarchy-age