osfeed.dev
Projects/akitaonrails / ai-usagebar

ai-usagebar

AI plan usage and credit balances in your bar and terminal

by@akitaonrails·Runs on Linux · macOS · Windows
Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v1.51.0 (2026-11-12), so it may lag behind newer releases.

Are you @akitaonrails?Claim it, and your coding agent keeps it current with each release
v1.51.0 · 49 things you can do 793 stars 38 changes to know before upgrading

See how much of your Claude, ChatGPT/Codex, Z.AI and other AI plan limits or credit balances you have used, in Waybar, a terminal app, GNOME or the macOS menu bar.

This page covers ai-usagebar up to v1.51.0. GitHub has v1.52.3 (), not published here yet. Maintainer? Publish it with your agent.

What you can do with ai-usagebar

Show your Claude subscription's 5-hour session and weekly usage, with reset times, in Waybar and a terminal.

Since v0.4.5
Good to know

Reads the OAuth credentials Claude Code stores in ~/.claude/.credentials.json and calls an undocumented usage endpoint that can change.

Share
Wrong?

Show your ChatGPT/Codex plan's usage limits in Waybar and a terminal.

Since v0.4.5
Good to know

Reads ~/.codex/auth.json and calls the same undocumented endpoint the Codex CLI uses.

Share
Wrong?

Show your Z.AI coding plan quota in Waybar and a terminal.

Since v0.4.5
Good to know

Needs a Z.AI API key in ZAI_API_KEY or in config.toml.

Share
Wrong?

Show how much of your OpenRouter credit you have used.

Since v0.4.5
Good to know

Needs an OpenRouter API key in OPENROUTER_API_KEY or in config.toml.

Share
Wrong?

Choose what the bar and tooltip show with format strings and color thresholds, compatible with claudebar.

Since v0.4.5
Share
Wrong?

Show your DeepSeek API credit balance.

Since v0.5.1
Good to know

Needs a DeepSeek API key; disabled by default.

Share
Wrong?
Show all 49

Run the usage terminal app on Windows.

Since v0.7.1
Good to know

The Waybar widget is Wayland-only; on Windows the TUI is the entry point.

Share
Wrong?

Show the 5-hour and weekly usage bars in the GNOME top panel.

Since v0.8.0
Good to know

Needs the ai-usagebar binary installed.

Share
Wrong?

Show usage bars in the macOS menu bar.

Since v0.8.0
Good to know

Needs the ai-usagebar binary installed.

Share
Wrong?

Track several Claude accounts side by side.

Since v0.12.0
Good to know

Anthropic only; --account cannot be combined with --creds-path.

Share
Wrong?

Show your Kimi coding plan's weekly quota and 5-hour window.

Since v0.16.0
Good to know

Needs KIMI_API_KEY or [kimi] api_key; disabled by default.

Share
Wrong?

Show the remaining prepaid credit on Kilo, Novita, Moonshot and Grok (xAI) accounts.

Since v0.16.0
Good to know

Each needs its own key; Grok needs a team-scoped Management key, not an inference key. Opt-in.

Share
Wrong?

Show your Anthropic API organization's spend for the current month, against a limit you set.

Since v0.16.0
Good to know

Needs an organization Console Admin key. Priority Tier costs are excluded, and completed daily buckets can omit today's spend.

Share
Wrong?

Show Google Antigravity's 5-hour and weekly quotas for both model pools.

Since v0.16.0
Good to know

Reads the quota from a running Antigravity app, IDE or agy session; at this release local-server discovery walks /proc, so Linux only.

Share
Wrong?

See how full the context window is in your recent Claude Code sessions.

Since v0.16.0
Good to know

Off by default; reads the last 100 session logs under ~/.claude/projects.

Share
Wrong?

Show how much of Cursor's included usage this billing cycle you have used.

Since v0.20.1
Good to know

Reads the session token from the Cursor IDE's local database, so sign in to the IDE first; calls an undocumented endpoint.

Share
Wrong?

Show your MiniMax Token Plan quota.

Since v0.20.1
Good to know

Needs a MiniMax key for the right region; opt-in.

Share
Wrong?

See and switch which Claude account the Claude Desktop app and the claude CLI are signed in as, on a Mac.

Since v0.20.1
Good to know

macOS only; switching the Desktop app quits and reopens it, and writes a rollback archive first.

Share
Wrong?

Show your SuperGrok subscription's included-credit usage and prepaid balance.

Since v1.1.0
Good to know

Needs the official Grok Build CLI signed in; opt-in.

Share
Wrong?

Show your OpenCode Go rolling, weekly and monthly usage.

Since v1.5.2
Good to know

Needs an OpenCode Go API key or the official CLI's existing login.

Share
Wrong?

Show Command Code's 5-hour and weekly spend windows and remaining monthly credit.

Since v1.9.1
Good to know

Reuses the login of the official Command Code CLI or pi; opt-in.

Share
Wrong?

Add your own provider by pointing at a JSON usage endpoint and mapping its fields to meters.

Since v1.14.0
Good to know

Needs an endpoint reachable with a static token.

Share
Wrong?

Show GitHub Copilot's premium-request, Chat and Completions quotas.

Since v1.14.0
Good to know

Uses the gh CLI's login (gh auth token) and an undocumented endpoint the VS Code extension calls.

Share
Wrong?

Find the AI tools already signed in on this machine and turn them on automatically.

Since v1.14.0
Good to know

Checks local credentials only; never re-enables a vendor you set to enabled = false.

Share
Wrong?

Show your Ollama Cloud usage quotas.

Since v1.18.1
Good to know

Needs a key from ollama.com/settings/keys; the local Ollama daemon has no quota data.

Share
Wrong?

Show the Grok Bot desktop app's weekly included usage.

Since v1.22.0
Good to know

Reads the desktop app's own session; Linux only at this release.

Share
Wrong?

Show the 5-hour and weekly windows of an Alibaba Cloud Model Studio Token Plan.

Since v1.22.0
Good to know

Needs bl auth login --console with the official bl CLI; opt-in.

Share
Wrong?

Get a desktop notification when a usage window crosses a threshold or a banked reset is about to expire.

Since v1.29.0
Good to know

Linux notifications through notify-send; best-effort delivery.

Share
Wrong?

Track Devin CLI daily and weekly quotas and optional overage balance.

Since v1.41.0
Good to know

Opt-in; reads the official CLI credential file without refreshing it. macOS credential paths are documented but untested; overage currency is not a verified universal contract.

Share
Wrong?

Track ClinePass five-hour, weekly and monthly limits with reset times.

Since v1.41.0
Good to know

Opt-in; needs the signed-in Cline CLI or an API key. CLI credentials are read without refreshing; lapsed tokens leave cached figures stale. Plans without ClinePass report no limits.

Share
Wrong?

Track Muse Code session and weekly subscription quotas with reset times.

Since v1.41.0
Good to know

Opt-in; requires the CLI's file-based OAuth login and issued key; Keychain-only logins are unsupported. Requests are limited to once per five minutes. Idle windows may be unknown or stale.

Share
Wrong?

Track Synthetic's regenerating weekly quota and credit budget.

Since v1.41.0
Good to know

Opt-in; needs `SYNTHETIC_API_KEY` or `[synthetic] api_key`.

Share
Wrong?

See how many live Claude Code sessions are working or waiting for input.

Since v1.41.0
Good to know

Reports require `[context] enabled = true`; the Waybar tooltip is always on. Reads sessions beside each account's credentials; excludes SDK runs and inactive leftovers. Desktop profiles have no activity line.

Share
Wrong?

Open an inactive Claude Desktop account's five-hour window without switching the app.

Since v1.41.0
Good to know

Disabled by default; set `desktop_prepare_binary` to a trusted recent Claude CLI supporting `--safe-mode` and `--no-session-persistence`. Runs one isolated Haiku turn and consumes some allowance; exhausted limits block it.

Share
Wrong?

Query AI plan usage from an MCP-compatible client.

Since v1.51.0
Good to know

Local stdio only; uses configured credentials and may contact providers. Cannot sign in, switch accounts, force refresh or change configuration.

Share
Wrong?

Track Factory Droid Standard quotas, Droid Core and extra-usage balance.

Since v1.51.0
Good to know

Opt-in; Linux Secret Service and the CLI's auth.v2.keyring store only. Other platforms and credential stores are unsupported.

Share
Wrong?

Track DeepRelay monthly allowances, rolling weekly caps and applicable wallet balance.

Since v1.51.0
Good to know

Opt-in; needs `DEEPRELAY_API_KEY` or `[deeprelay] api_key` with billing:read scope. Weekly caps slide and have no reset date.

Share
Wrong?

Track Mistral API and Vibe Code monthly budgets.

Since v1.51.0
Good to know

Opt-in; explicit key with see_org_inference_usage permission required. No automatic credential discovery; API budget absent on plans that omit it.

Share
Wrong?

Choose which provider to use before its weekly quota resets unused.

Since v1.51.0
Good to know

Opt-in estimates based on weekly windows and usage pace; stores 25 hours of local percentage history only while enabled. Not a guarantee of future usage.

Share
Wrong?

Copy a provider's usage card to the clipboard as a PNG.

Since v1.51.0
Good to know

Copies one card in the current theme with an opaque background.

Share
Wrong?

Before you upgrade ai-usagebar

Newest first
v1.51.0

Provider switches now enable or disable fetching in `config.toml`; previously hidden cards reappear. Accounts share a provider card with remembered account tabs; use the provider switch to turn it off.

Behavior changedAffects: Tray users with hidden cards or several accounts
Read the evidence
Share
Wrong?
Show 35 older
v1.51.0

Update custom `--format` strings that expect dollars: `{oai_credit_balance}` now emits a credit count. Message estimates leave the credit display, but `{oai_local_msgs}` and `{oai_cloud_msgs}` remain available.

Action requiredAffects: Custom formats consuming the Codex dollar-form credit balance
Read the evidence
Share
Wrong?
v1.51.0

Update formats treating `{synthetic_requests}` and `{synthetic_limit}` as requests: they now mean weekly credits and can be empty. Reset placeholders now count down to a partial refill; `{weekly_pct}` and `{weekly_reset}` are available.

Action requiredAffects: Synthetic custom formats or integrations using request counters and full-reset semantics
Read the evidence
Share
Wrong?
v1.51.0

Plan labels become Ultra and Max. Verified Ultra accounts omit the absent five-hour quota; default bars show weekly usage and `{session_*}` expands empty. Add `{weekly_pct}` to a session-only custom format.

Behavior changedAffects: Claude users, especially verified Ultra accounts and session-only custom formats
Read the evidence
Share
Wrong?
v1.41.0

To show another directory's sessions, point `[anthropic] credentials_path` at its `.credentials.json` or add a named account; exporting `CLAUDE_CONFIG_DIR` no longer moves the default tooltip's activity line.

Action requiredAffects: Users who redirected the v1.33.0 default Claude tooltip activity line with CLAUDE_CONFIG_DIR
Read the evidence
Share
Wrong?
v1.41.0

Logos now shows one allowance per provider; the Name look is renamed Quattro (`"name"` remains accepted). Hidden metrics no longer set its headline. From v1.35.0 meter fill always means consumed quota; Used/Left changes numbers and tooltips.

Behavior changedAffects: macOS tray users
Read the evidence
Share
Wrong?
v1.41.0

When migrating from a bare executable, quit it, install and launch `AI Usage.app` in `/Applications`, then toggle Launch at Login off and on to update the saved path.

Action requiredAffects: macOS users migrating their tray installation from a bare executable to the app bundle
Read the evidence
Share
Wrong?
v1.41.0

`[ui] overview_vendors` now leads the TUI tabs and report entry order; other enabled vendors follow in canonical order. Linux Mint reads the same report field; an explicitly empty list does not promote `primary`.

Behavior changedAffects: Users with [ui] overview_vendors configured and consumers rendering report entries in order
Read the evidence
Share
Wrong?
v1.41.0

Fallback now asks `agy -p "/quota"` before Cloud Code when installed, at most every two minutes, with ten minutes before retrying failure; pin `agy_binary` if needed. Cloud Code tries prod before daily to include Gemini quotas.

Behavior changedAffects: Antigravity users relying on fallback quota collection
Read the evidence
Share
Wrong?
v1.41.0

Early in a long quota window (under 15% elapsed), accelerated usage with at least half the allowance remaining warns as over pace rather than critical; Windows tray quota severity no longer turns red for a high-context Claude session alone.

Behavior changedAffects: Users watching pacing warnings or the Windows tray icon
Read the evidence
Share
Wrong?
v1.41.0

HTTPS trusts the OS certificate store alongside bundled roots, allowing vendor requests through TLS-inspecting proxies whose root is installed in the system store; transport errors expose certificate causes.

Behavior changedAffects: Users behind corporate TLS-inspecting proxies
Read the evidence
Share
Wrong?
v1.22.0

Scripts that relied on usage failing when every account failed must read each entry's error field instead: usage now exits 0 whenever it prints a full report. The JSON primary field is now an entry id such as anthropic@work, not a bare vendor slug.

Action requiredAffects: Scripts reading the usage command's exit code or the primary field
Read the evidence
Share
Wrong?
ai-usagebar release history 18
v1.51.0
with v1.42.0, v1.43.0, v1.44.0, v1.45.0, v1.46.0, v1.47.0, v1.48.0, v1.48.1, v1.48.2, v1.48.3, v1.49.0, v1.50.0

Choose which AI plan to use before its weekly quota resets unused.

Details

`usage --json --priorities` adds opt-in forecasts and an Omarchy priorities view. New provider integrations and login fixes accompany explicit migrations for credit placeholders and Mistral custom-provider configurations.

Also: Adds MCP queries, Droid, DeepRelay and Mistral; tray sign-in and card copying; fixes account readings; changes Codex credit formats and Synthetic quota semantics.

v1.51.0 release binaries for Linux, macOS and Windows, plus AUR and crates.io; source builds require Rust 1.90. New providers are opt-in; Droid supports Linux only.

Added: Query AI plan usage from an MCP-compatible client.Added / inferred: Track Factory Droid Standard quotas, Droid Core and…Added: Track DeepRelay monthly allowances, rolling weekly…Added: Track Mistral API and Vibe Code monthly budgets.Action required: Add your own provider by pointing at a JSON usage e…Added: Choose which provider to use before its weekly quot…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Now works: Show your AI usage in Omarchy's Quattro bar as a na…Behavior changed: Show your AI usage in Omarchy's Quattro bar as a na…Improved: Show the 5-hour and weekly usage bars in the GNOME…Now works: Show every provider's usage in a KDE Plasma 6 panel…Improved: Show every provider's usage in a KDE Plasma 6 panel…Improved: Open a usage dashboard from a tray icon on Windows.Added: Copy a provider's usage card to the clipboard as a…Behavior changed: Open a usage dashboard from a tray icon on Windows.Improved: Open a usage dashboard from a tray icon on Windows.Improved: Show usage bars in the macOS menu bar.Behavior changed: Show usage bars in the macOS menu bar.Improved: Track Devin CLI daily and weekly quotas and optiona…Improved: Show your SuperGrok subscription's included-credit…Now works: Show your OpenCode Go rolling, weekly and monthly u…Now works: Track ClinePass five-hour, weekly and monthly limit…Behavior changed: Show Google Antigravity's 5-hour and weekly quotas…Improved: Show your ChatGPT/Codex plan's usage limits in Wayb…Action required: Show your ChatGPT/Codex plan's usage limits in Wayb…Now works: Track Synthetic's regenerating weekly quota and cre…Action required: Track Synthetic's regenerating weekly quota and cre…Behavior changed: Track Synthetic's regenerating weekly quota and cre…Now works: Get a desktop notification when a usage window cros…Now works: Show how much of Cursor's included usage this billi…Now works: Show GitHub Copilot's premium-request, Chat and Com…Improved: Show your Claude subscription's 5-hour session and…Behavior changed: Show your Claude subscription's 5-hour session and…Behavior changed: Open an inactive Claude Desktop account's five-hour…Now works: Show your Claude subscription's 5-hour session and…Now works: Track several Claude accounts side by side.Now works: See and switch which Claude account the Claude Desk…Now works: Show your Anthropic API organization's spend for th…Improved: Show your Anthropic API organization's spend for th…Now works: Show your Kimi coding plan's weekly quota and 5-hou…Improved: Show your Kiro CLI credit pool.Improved: Print every vendor's usage and reset times in the t…Now works: Choose what the bar and tooltip show with format st…Now works: Check every enabled vendor's usage in a tabbed term…Behavior changedNow works: Print every vendor's usage and reset times in the t…Behavior changed

Seeded by @iluxav with Codex

Read the evidence
v1.41.0
with v1.33.0, v1.34.0, v1.35.0, v1.36.0, v1.37.0, v1.38.0, v1.38.1, v1.39.0, v1.39.1, v1.40.0, v1.40.1

Track ClinePass subscription limits alongside your other AI plans.

Details

Enable `[cline]`, `[devin]`, `[muse-code]` or `[synthetic]` for the new providers. The grouped releases also add tray account controls and display filters, fix quota collection and monthly-only plans, and change meter fill and fallback behavior.

Also: Adds Devin, Muse Code and Synthetic quotas, live Claude session activity, Copilot accounts, Desktop account preparation, GNOME multi-provider indicators and per-metric KDE controls.

v1.41.0 via GitHub release binaries, AUR or crates.io; source builds require Rust 1.90. New providers are opt-in and need their documented login or API key.

Added: Track Devin CLI daily and weekly quotas and optiona…Added: Track ClinePass five-hour, weekly and monthly limit…Added: Track Muse Code session and weekly subscription quo…Added: Track Synthetic's regenerating weekly quota and cre…Added: See how many live Claude Code sessions are working…Action required: See how many live Claude Code sessions are working…Improved: Show GitHub Copilot's premium-request, Chat and Com…Improved: Show your OpenCode Go rolling, weekly and monthly u…Now works: Show your Ollama Cloud usage quotas.Improved: Show the 5-hour and weekly windows of an Alibaba Cl…Improved: Show your Nous Research subscription usage.Now works: Show the remaining prepaid credit on Kilo, Novita,…Improved: See and switch which Claude account the Claude Desk…Added: Open an inactive Claude Desktop account's five-hour…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Behavior changed: Show usage bars in the macOS menu bar.Improved: Open a usage dashboard from a tray icon on Windows.Now works: Open a usage dashboard from a tray icon on Windows.Action required: Show usage bars in the macOS menu bar.Improved: Show every provider's usage in a KDE Plasma 6 panel…Improved: Show the 5-hour and weekly usage bars in the GNOME…Behavior changed: Check every enabled vendor's usage in a tabbed term…Improved: Print every vendor's usage and reset times in the t…Now works: Open a usage dashboard from a tray icon on Windows.Improved: Show Google Antigravity's 5-hour and weekly quotas…Behavior changed: Show Google Antigravity's 5-hour and weekly quotas…Improved: Show Google Antigravity's 5-hour and weekly quotas…Improved: Show your SuperGrok subscription's included-credit…Improved: Add your own provider by pointing at a JSON usage e…Behavior changed: Get a desktop notification when a usage window cros…Behavior changed: Show your Anthropic API organization's spend for th…Now works: Show your Claude subscription's 5-hour session and…Behavior changedBehavior changedNow works: Choose what the bar and tooltip show with format st…Now works: Show your Claude subscription's 5-hour session and…Now works: Show your ChatGPT/Codex plan's usage limits in Wayb…

Seeded by @iluxav with Codex

Read the evidence
v1.32.0

See whether your Cursor usage is on pace for the billing cycle.

Details

Cursor gets billing-cycle pacing and spending-page credits; OpenRouter shows its two most recent models' cost and the dollar balance; Lyceum Technology is a new balance provider. The Omarchy panel can color usage by level (colorCodeUsage) and speaks English, Russian and Brazilian Portuguese. On macOS, Claude account switching moved from the dropdown into Preferences. Groups v1.30.0 to v1.32.0.

Also: The macOS menu bar can show one provider like the Quattro bar; the Linux Mint tray polls every five minutes instead of every minute; ai-usagebar-bin installs again from the AUR.

v1.32.0.

Improved: Show how much of Cursor's included usage this billi…Improved: Show how much of your OpenRouter credit you have us…Improved: Show the remaining prepaid credit on Kilo, Novita,…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Behavior changed: See and switch which Claude account the Claude Desk…Behavior changed: Open a usage dashboard from a tray icon on Windows.

Seeded by @iluxav with Claude Code

Read the evidence
v1.29.0

Get a desktop notification when any AI limit is about to run out.

Details

[notifications] threshold (default 97%) sends notify-send alerts, and banked resets warn 48 hours before they expire. account switch and account add work for Codex (--codex). Named accounts work for every API-key provider, Claude banked resets are shown, and DeepInfra is a new vendor. An experimental Linux Mint Cinnamon tray was added. Groups v1.23.0 to v1.29.0.

Also: Claude Code session context rows in the report; OpenRouter across workspaces; Grok Bot on Windows; the macOS tray updates itself; GNOME menu lists every provider; meters turn red only past 110% of the pace line.

v1.29.0; building from source now needs Rust 1.90. The ai-usagebar-bin AUR package now checks PGP signatures.

Added: Get a desktop notification when a usage window cros…Improved: See and switch which Claude account the Claude Desk…Improved: Show your Claude subscription's 5-hour session and…Improved: Show the remaining prepaid credit on Kilo, Novita,…Improved: Open a usage dashboard from a tray icon on Windows.Action requiredAction required: Open a usage dashboard from a tray icon on Windows.Behavior changed

Seeded by @iluxav with Claude Code

Read the evidence
v1.22.0

Open the usage dashboard from the macOS menu bar tray, as on Windows.

Details

macOS gets the WebView tray (ai-usagebar-tray). New vendors: grokbot (Grok Bot desktop app, Linux), modelstudio (Alibaba Cloud Model Studio via the bl CLI login) and orcarouter. [vendor] display_limit turns a prepaid balance into a meter and [vendor] headline chooses amount or percent for the bar. usage now exits 0 whenever it prints a full report, and usage --json's primary is an entry id. Groups v1.19.0 to v1.22.0.

v1.22.0; Windows also via Scoop.

Improved: Open a usage dashboard from a tray icon on Windows.Added: Show the Grok Bot desktop app's weekly included usa…Added: Show the 5-hour and weekly windows of an Alibaba Cl…Improved: Show the remaining prepaid credit on Kilo, Novita,…Action required: Print every vendor's usage and reset times in the t…Now works: Track several Claude accounts side by side.

Seeded by @iluxav with Claude Code

Read the evidence
v1.18.1

Track your Ollama Cloud usage, including monthly quotas.

Details

New ollama vendor with a key from ollama.com/settings/keys. The Omarchy settings can pin the bar to the session, weekly or monthly window (barWindow). ai-usagebar settings enable <vendor> turns one provider on. usage --json now carries schema_version: 1. On macOS, refreshed Claude Code credentials keep a Keychain partition Claude Code can read. Groups v1.15.0 to v1.18.1.

Also: Custom providers can set a logo; the macOS menu bar covers Copilot, SuperGrok and other CLI vendors; Cursor Enterprise on-demand spend and limit.

v1.18.1.

Added: Show your Ollama Cloud usage quotas.Improved: Show your AI usage in Omarchy's Quattro bar as a na…Action required: Show your Claude subscription's 5-hour session and…Improved: Print every vendor's usage and reset times in the t…

Seeded by @iluxav with Claude Code

Read the evidence
v1.14.0

Track any AI service that has a JSON usage endpoint by declaring it in your config.

Details

[[custom]] providers map a JSON endpoint to meters with JSON Pointers. New copilot vendor uses gh auth token. ai-usagebar detect finds installed tools and enables them (never overriding enabled = false). Windows gets a system-tray popover (ai-usagebar-tray) with in-app updates. Codex and SuperGrok banked reset credits show with their expiry. Groups v1.10.0 to v1.14.0.

Also: Omarchy bar can show every provider at once; vendors --json lists the catalog; --config <path> on both binaries; HTTP 429 now triggers a 5-minute backoff that serves the last good numbers.

v1.14.0.

Added: Add your own provider by pointing at a JSON usage e…Added: Show GitHub Copilot's premium-request, Chat and Com…Added: Find the AI tools already signed in on this machine…Added: Open a usage dashboard from a tray icon on Windows.Improved: Show your ChatGPT/Codex plan's usage limits in Wayb…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Behavior changed

Seeded by @iluxav with Claude Code

Read the evidence
v1.9.1

Track several Codex logins side by side, each with its own bar item and cache.

Details

[[openai.accounts]] (label plus codex_auth_path) with --account <label>. New commandcode vendor reuses the Command Code or pi CLI login. Kimi accepts a Kimi For Coding subscription and its default format shows both quotas (5h X% · 7d Y%). A Nix flake supports nix run, NixOS and Home Manager. Groups v1.6.0 to v1.9.1.

Also: EUR, GBP, BRL and JPY amounts use their symbols; Z.AI's MCP-tools pool on macOS; SuperGrok works again with grok CLI 1.0.13.

v1.9.1; also installable with nix run.

Improved: Show your ChatGPT/Codex plan's usage limits in Wayb…Added: Show Command Code's 5-hour and weekly spend windows…Improved: Show your Kimi coding plan's weekly quota and 5-hou…Behavior changed: Show your Kimi coding plan's weekly quota and 5-hou…Now works: Show your SuperGrok subscription's included-credit…

Seeded by @iluxav with Claude Code

Read the evidence
v1.5.2

Track Nous Research and OpenCode Go plans, and several OpenRouter keys.

Details

New vendors for Nous Research (OAuth device flow) and OpenCode Go (API key). [[openrouter.accounts]] adds named OpenRouter keys. Negative balances now show with their sign (-$5.71) and as critical. The Omarchy panel remembers the selected provider, can hide the number for an icon-only bar entry, and shows the clock time a limit reopens. Groups v1.2.0 to v1.5.2.

Also: Pace placeholders for Z.AI and MiniMax; Antigravity found on Windows without ANTIGRAVITY_LS_ADDRESS; Z.AI's CREDIT_LIMIT bucket accepted.

v1.5.2.

Added: Show your Nous Research subscription usage.Added: Show your OpenCode Go rolling, weekly and monthly u…Improved: Show how much of your OpenRouter credit you have us…Improved: Show your AI usage in Omarchy's Quattro bar as a na…Now works: Show Google Antigravity's 5-hour and weekly quotas…Behavior changed

Seeded by @iluxav with Claude Code

Read the evidence
v1.1.0

Use ai-usagebar as a native Omarchy plugin in the Quattro bar.

Details

The repository installs with omarchy plugin add and renders every provider in the Omarchy 4 (Quattro) shell, with a settings form. A KDE Plasma 6 plasmoid was added. New vendors supergrok (via the Grok Build CLI) and kiro (via kiro-cli's login). ai-usagebar usage --json gained status, stale, fetched_at, severity and reset_at. Groups v0.22.0 to v1.1.0.

Also: --version flag; Cursor falls back to cursor-agent's login; Antigravity works on macOS.

v1.1.0; first stable release line (v1.0.0).

Added: Show your AI usage in Omarchy's Quattro bar as a na…Added: Show every provider's usage in a KDE Plasma 6 panel…Added: Show your SuperGrok subscription's included-credit…Added: Show your Kiro CLI credit pool.Now works: Show Google Antigravity's 5-hour and weekly quotas…Behavior changed

Seeded by @iluxav with Claude Code

Read the evidence
v0.21.0

Print the quota and time-to-reset of every configured vendor and account with one command.

Details

New ai-usagebar usage command, with --json for scripts; it exits non-zero only when every entry failed. On macOS, saved Claude Desktop accounts report usage without a separate claude CLI login.

Also: The TUI keeps the last numbers on screen while refreshing instead of flickering.

v0.21.0.

Added: Print every vendor's usage and reset times in the t…Improved: Track several Claude accounts side by side.

Seeded by @iluxav with Claude Code

Read the evidence
v0.20.1

See every vendor's key limit at once in an overview, instead of switching tabs.

Details

The TUI and macOS menu bar gained an Overview listing every vendor ([ui] overview_vendors picks them). New vendors: cursor (included-usage pools from the IDE's local login) and minimax. [anthropic] accounts_dir discovers accounts from CLAUDE_CONFIG_DIR folders, account add <label> creates and signs in a new one, and the TUI and menu bar reload config.toml on save. On macOS, account status and account switch show and change the signed-in Claude Desktop and CLI accounts. Groups v0.17.0 to v0.20.1.

Also: [ui] vendor_box = sidebar, navbar or none; the macOS app covers all vendors, with a ring layout and a start-at-login toggle.

v0.20.1; account switching is macOS-only.

Added: See one compact row per vendor with its key limit,…Added: Show how much of Cursor's included usage this billi…Added: Show your MiniMax Token Plan quota.Improved: Track several Claude accounts side by side.Added: See and switch which Claude account the Claude Desk…Improved: Check every enabled vendor's usage in a tabbed term…Action required: Show the remaining prepaid credit on Kilo, Novita,…

Seeded by @iluxav with Claude Code

Read the evidence
v0.16.0

Track prepaid API balances for Kilo, Novita, Moonshot and Grok, and your Anthropic API month-to-date spend, alongside your plan limits.

Details

New vendors: kimi (weekly and 5-hour quota), kilo, novita, moonshot, grok (prepaid balance via a Management key), anthropic_api (month-to-date cost via an Admin key) and antigravity (Google Antigravity's local quota). The TUI gained an opt-in Claude Code context monitor (c), and config.toml now rejects unknown top-level sections. Groups v0.13.0 to v0.16.0.

Also: Pace markers on the macOS and GNOME bars; {scoped_*} placeholders for model-scoped weekly limits; extra-usage spend shown on uncapped plans and in its own currency; ~ expanded in credential paths.

v0.16.0; every new vendor is opt-in. The GNOME extension supports GNOME Shell 45 to 50.

Added: Show your Kimi coding plan's weekly quota and 5-hou…Added: Show the remaining prepaid credit on Kilo, Novita,…Added: Show your Anthropic API organization's spend for th…Added / inferred: Show Google Antigravity's 5-hour and weekly quotas…Added: See how full the context window is in your recent C…Action requiredBehavior changedNow works: Show your Claude subscription's 5-hour session and…

Seeded by @iluxav with Claude Code

Read the evidence
v0.12.0

Track several Claude subscriptions at once, each with its own bar item and TUI tab.

Details

Declare accounts under [[anthropic.accounts]] (label, credentials_path) and pick one with --account <label>; each has its own cache, and the TUI shows a tab per account. --cache-dir and --creds-path became documented flags. Model-scoped weekly limits such as the Fable weekly cap now show in the tooltip, the TUI and the bar's severity. Groups v0.9.0 to v0.12.0.

v0.12.0.

Added: Track several Claude accounts side by side.Improved: Show your Claude subscription's 5-hour session and…Behavior changed: Show your Claude subscription's 5-hour session and…

Seeded by @iluxav with Claude Code

Read the evidence
v0.8.0

See your Claude usage bars in the GNOME top panel or the macOS menu bar.

Details

New GNOME Shell extension (gnome-extension/) and native macOS menu bar app (macos/), both driving the ai-usagebar binary, with preferences and credential helpers. v0.7.2 stopped a false 0% on recent Claude Code builds that leave the refresh token empty. Groups v0.7.2 and v0.8.0.

v0.8.0; the GNOME extension and macOS app are installed from the repository folders.

Added: Show the 5-hour and weekly usage bars in the GNOME…Added: Show usage bars in the macOS menu bar.Now works: Show your Claude subscription's 5-hour session and…

Seeded by @iluxav with Claude Code

Read the evidence
v0.7.1

Check your AI plan usage on Windows with the terminal app.

Details

ai-usagebar and ai-usagebar-tui now run natively on Windows, finding credentials under %USERPROFILE%. The TUI got a new dashboard look with a vendor sidebar. [anthropic] credentials_path in config.toml is now honored by the widget. Groups v0.6.0 to v0.7.1.

v0.7.1; building from source now needs Rust 1.88.

Added: Run the usage terminal app on Windows.Now works: Show your Claude subscription's 5-hour session and…Behavior changed: Check every enabled vendor's usage in a tabbed term…Action required

Seeded by @iluxav with Claude Code

Read the evidence
v0.5.1

Track your DeepSeek credit balance next to your other AI plans.

Details

New --vendor deepseek reads the balance from DeepSeek's /user/balance, in USD when available, with DEEPSEEK_API_KEY or [deepseek] api_key. On macOS, Claude credentials are read from the login Keychain when ~/.claude/.credentials.json is missing. Groups v0.5.0 and v0.5.1.

v0.5.1; DeepSeek is off until a key is configured.

Added: Show your DeepSeek API credit balance.Now works: Show your Claude subscription's 5-hour session and…

Seeded by @iluxav with Claude Code

Read the evidence
v0.4.5
First release

See how much of your Claude plan's session and weekly limits you have used, right in Waybar.

Details

First releases (v0.1.0 to v0.4.5). The ai-usagebar binary prints Waybar JSON per vendor (Anthropic via ~/.claude/.credentials.json, OpenAI Codex via ~/.codex/auth.json, Z.AI via ZAI_API_KEY, OpenRouter via OPENROUTER_API_KEY); ai-usagebar-tui shows one tab per vendor. It takes claudebar's flags and placeholders (--format, --tooltip-format, --icon, --pace-tolerance, --color-*), and --cycle-next/--cycle-prev switch the vendor shown.

Also: Settings overlay in the TUI (s) to pick the primary vendor and enter API keys, saved with chmod 600; config edits signal Waybar to refresh at once; timestamps in local time.

cargo install ai-usagebar, cargo binstall ai-usagebar, or the AUR packages ai-usagebar and ai-usagebar-bin (x86_64 and aarch64 Linux).

Added: Show your Claude subscription's 5-hour session and…Added: Show your ChatGPT/Codex plan's usage limits in Wayb…Added: Show your Z.AI coding plan quota in Waybar and a te…Added: Show how much of your OpenRouter credit you have us…Added: Check every enabled vendor's usage in a tabbed term…Added: Use one bar item for several AI vendors and scroll…Added: Choose what the bar and tooltip show with format st…

Seeded by @iluxav with Claude Code

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky