akitaonrails

akitaonrails / ai-usagebar

Public

Rust-based waybar widget to monitor status of Claude, GPT, GLM, OpenRouter plans/credits - inspired by claudebar/codexbar

12
1
89% credibility
Found May 24, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

ai-usagebar is a desktop widget and terminal app that monitors how much you've used your AI service quotas (Claude, ChatGPT, Z.AI, OpenRouter). It displays usage percentages and reset timers on your Linux status bar, with automatic credential refresh and caching to avoid hitting API limits. You can view all vendors at once in a colorful terminal window or cycle through them with your mouse scroll wheel.

How It Works

1
💡 You want to track your AI usage

You pay for Claude, ChatGPT, or other AI services and want to see at a glance how much quota you've used.

2
📦 You install the widget

You install ai-usagebar from your Linux package manager (like yay on Arch) or compile it from source.

3
🔐 You connect your accounts

For Claude and ChatGPT, you just run their login commands once. For Z.AI and OpenRouter, you enter your API key in the settings screen.

4
✨ Your usage appears on screen

A small widget shows up on your status bar displaying 'Claude 62% · 1h 30m' or similar, with a color that changes as you get closer to your limit.

5
You choose how to view your data
🔄
Scroll to cycle vendors

Use your mouse scroll wheel on the widget to quickly check different services one at a time.

🖱️
Click to open full view

Click the widget to open a colorful terminal window showing all your AI services side by side.

6
⚙️ Everything stays up to date

The widget refreshes automatically every few minutes, and your credentials are kept fresh without you having to do anything.

🎉 You always know your usage

No more surprise 'out of quota' errors mid-conversation. Your AI usage is always visible on your screen.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 12 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ai-usagebar?

ai-usagebar is a Rust-powered Waybar widget and terminal UI that monitors your AI service quotas in real time. It tracks usage across Anthropic Claude, OpenAI Codex/ChatGPT, Z.AI, and OpenRouter, showing session percentages, reset countdowns, and pacing indicators so you know exactly when you're about to hit a limit. The project ships two binaries: the widget itself for your panel, and a standalone TUI you can run in any terminal without Waybar at all. Configuration lives in a simple TOML file, and authentication reuses credentials from the official CLI tools where possible.

Why is it gaining traction?

The killer feature is that it works out of the box with your existing Claude and Codex logins—no API keys to manage for those vendors. The TUI gives you a full dashboard across all four services at once, with tab switching and auto-refresh. Developers who live in the terminal appreciate that scroll-wheel cycling through vendors on the bar itself works without clicking. The project also includes live API smoke tests that catch endpoint drift early, which matters when you're hitting undocumented APIs.

Who should use this?

Developers who pay for Claude Pro, Max, or Codex subscriptions and want visibility before a long coding session gets cut short. DevOps folks running multi-monitor Waybar setups will appreciate the flock-protected cache preventing API stampedes. Anyone who prefers terminal-native tools over browser-based account dashboards will find the TUI useful as a standalone app.

Verdict

This is a well-engineered tool solving a real pain point, but the 12-star count and sub-1% credibility score reflect its early-stage status. The documentation is thorough and the codebase has solid test coverage, but three of four API endpoints are undocumented—expect occasional maintenance when vendors change their schemas. Worth installing if you regularly bump into AI rate limits; check the AUR or build from source if you're comfortable with a project still finding its footing.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.