Skip to content
Akita's AI Lair
EnglishPortuguês (Brasil)Españolעברית日本語한국어
Menu
WorkflowSkills, tmux and the daily loopToolsai-usagebarQuota and reset times for 24 AI providersghpendingEvery open PR and issue in one listtclockA terminal clock with command widgetsai-memoryLong-term memory for coding agentsai-jailAn OS sandbox for AI coding agentsWritingThe blog and the LLM benchmarkNewsletterThe M.Akita Chronicles, every MondayPodcastsLong conversations about AI, on videoGamesMy game collection as code, on OmarchySetupOmarchy, tmux, and what I set asideFollow
ai-usagebar

Know how much AI you have left, before it runs out

ai-usagebar reads each plan's usage from the provider and shows it where you already look: the top bar, a terminal UI or the system tray. It began as a Rust port of claudebar and now covers 24 providers.

InstallGitHub
The ai-usagebar panel open under the Omarchy top bar: Z.AI GLM Coding Pro with session, weekly and monthly MCP quotas at 1%, their reset times, and tabs for Claude, Codex, Z.AI, OpenRouter and Kimi.

Why I built it

I pay for several coding plans and each one meters differently: a 5-hour window here, a weekly cap there, a prepaid balance somewhere else. Opening five dashboards to decide which agent gets the next task was silly. Now one glance at the bar tells me.

Seven provider chips, Claude, Codex, Copilot, Z.AI, OpenRouter, Kimi and DeepSeek, feed one bar with a gauge. The zoomed panel shows three meters, the first nearly full with a red marker labelled Alert at 97%, and a Resets in clock.
How it fits my workflow

Wherever you work

The same Rust core feeds every front end, so the numbers match everywhere.

The ai-usagebar TUI on the OpenAI tab: Codex 5-hour window at 6% and weekly at 1%, with reset times and pace, and a credits section.

Terminal UI

ai-usagebar-tui: a tab per provider, refreshed every 60 seconds, with a settings overlay.

The macOS tray popover listing Claude Max, Codex, Cursor, SuperGrok and Antigravity, each with usage bars, percentage used and reset times.

macOS menu bar

A native popover with every enabled provider, pace markers and reset times.

The Windows tray dashboard with provider usage bars.

Windows tray

A notification-area icon with a WebView2 popover. Installs with Scoop.

The KDE Plasma 6 plasmoid showing provider tabs and usage bars.

KDE Plasma 6

A plasmoid with provider tabs. Each applet instance can follow a different provider.

What it does for you

Alerts before the wall

A desktop notification when a quota window crosses 97%, a critical one at 100%, and a warning 48 hours before banked reset credits expire. The threshold is yours to change.

Finds your accounts

ai-usagebar detect turns on every provider that already has a credential on the machine. It reads local files and keychains, never the network.

Keeps showing the last good number

Network failures keep the previous data on screen. A provider that answers HTTP 429 is left alone for five minutes.

Several accounts

Named Claude, Codex and OpenRouter accounts side by side, each with its own entry.

Drop-in for claudebar

Same Waybar JSON, flags, Pango tooltip, Omarchy theme detection and locked OAuth refresh.

Scriptable

ai-usagebar usage --json prints every provider's quota and reset time as one document.

24 providers

The command line and the TUI support all of them. Desktop coverage varies by integration; the README has the table.

  • Claude
  • Anthropic API
  • Codex
  • GitHub Copilot
  • Z.AI
  • OpenRouter
  • DeepSeek
  • Kimi
  • Kilo
  • Novita
  • Moonshot
  • Grok
  • SuperGrok
  • Grok Bot
  • Antigravity
  • Cursor
  • MiniMax
  • Kiro
  • Nous Research
  • OpenCode Go
  • Command Code
  • Ollama Cloud
  • OrcaRouter
  • Model Studio

Install

Pick your platform. On Omarchy Quattro you need both the binary and the plugin.

terminal
omarchy pkg aur add ai-usagebar-bin &&  omarchy plugin add https://github.com/akitaonrails/ai-usagebar.git --enable

Then turn on what you already use and look:

terminal
ai-usagebar detect     # enable providers you already have credentials forai-usagebar usage      # every quota and reset timeai-usagebar-tui        # the terminal UI
Everything else is in the README

More on my blog

The longer versions, with the details and the dead ends.

Keep going

The workflow

Where the quota gauge decides which agent gets the next task.

ghpending

The other thing I look at every morning.

tclock

The clock that hosts the dashboard on my second monitor.

Everything here is open source

The tools, the skills and the benchmark are public repositories. Fork them and build the version that fits the way you work.

See all my repositoriesRead the blog