Built by @akitaonrails on GitHub. This page was written by @iluxav from public sources, last updated for v1.32.0 (2026-10-04), and may lag behind new releases.
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.
What you can do with it
Show your Claude subscription's 5-hour session and weekly usage, with reset times, in Waybar and a terminal.
Good to know
Reads the OAuth credentials Claude Code stores in ~/.claude/.credentials.json and calls an undocumented usage endpoint that can change.
Since v0.4.5
Show your ChatGPT/Codex plan's usage limits in Waybar and a terminal.
Good to know
Reads ~/.codex/auth.json and calls the same undocumented endpoint the Codex CLI uses.
Since v0.4.5
Show your Z.AI coding plan quota in Waybar and a terminal.
Good to know
Needs a Z.AI API key in ZAI_API_KEY or in config.toml.
Since v0.4.5
Show how much of your OpenRouter credit you have used.
Good to know
Needs an OpenRouter API key in OPENROUTER_API_KEY or in config.toml.
Since v0.4.5
Check every enabled vendor's usage in a tabbed terminal app, without Waybar.
Since v0.4.5
Use one bar item for several AI vendors and scroll to switch between them.
Since v0.4.5
Choose what the bar and tooltip show with format strings and color thresholds, compatible with claudebar.
Since v0.4.5
Show your DeepSeek API credit balance.
Good to know
Needs a DeepSeek API key; disabled by default.
Since v0.5.1
Show all 37
Run the usage terminal app on Windows.
Good to know
The Waybar widget is Wayland-only; on Windows the TUI is the entry point.
Since v0.7.1
Show the 5-hour and weekly usage bars in the GNOME top panel.
Good to know
Needs the ai-usagebar binary installed.
Since v0.8.0
Show usage bars in the macOS menu bar.
Good to know
Needs the ai-usagebar binary installed.
Since v0.8.0
Track several Claude accounts side by side.
Good to know
Anthropic only; --account cannot be combined with --creds-path.
Since v0.12.0
Show your Kimi coding plan's weekly quota and 5-hour window.
Good to know
Needs KIMI_API_KEY or [kimi] api_key; disabled by default.
Since v0.16.0
Show the remaining prepaid credit on Kilo, Novita, Moonshot and Grok (xAI) accounts.
Good to know
Each needs its own key; Grok needs a team-scoped Management key, not an inference key. Opt-in.
Since v0.16.0
Show your Anthropic API organization's spend for the current month, against a limit you set.
Good to know
Needs a Console Admin key, only available to organization accounts; Priority Tier costs are not included, so the figure can be below the real total.
Since v0.16.0
Show Google Antigravity's 5-hour and weekly quotas for both model pools.
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.
Since v0.16.0
See how full the context window is in your recent Claude Code sessions.
Good to know
Off by default; reads the last 100 session logs under ~/.claude/projects.
Since v0.16.0
See one compact row per vendor with its key limit, colored by severity.
Since v0.20.1
Show how much of Cursor's included usage this billing cycle you have used.
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.
Since v0.20.1
Show your MiniMax Token Plan quota.
Good to know
Needs a MiniMax key for the right region; opt-in.
Since v0.20.1
See and switch which Claude account the Claude Desktop app and the claude CLI are signed in as, on a Mac.
Good to know
macOS only; switching the Desktop app quits and reopens it, and writes a rollback archive first.
Since v0.20.1
Print every vendor's usage and reset times in the terminal or as JSON.
Since v0.21.0
Show your AI usage in Omarchy's Quattro bar as a native plugin, with a panel and settings.
Good to know
Needs the ai-usagebar binary installed.
Since v1.1.0
Show every provider's usage in a KDE Plasma 6 panel widget.
Since v1.1.0
Show your SuperGrok subscription's included-credit usage and prepaid balance.
Good to know
Needs the official Grok Build CLI signed in; opt-in.
Since v1.1.0
Show your Kiro CLI credit pool.
Good to know
Needs kiro-cli login; opt-in.
Since v1.1.0
Show your Nous Research subscription usage.
Since v1.5.2
Show your OpenCode Go rolling, weekly and monthly usage.
Good to know
Needs an OpenCode Go API key.
Since v1.5.2
Show Command Code's 5-hour and weekly spend windows and remaining monthly credit.
Good to know
Reuses the login of the official Command Code CLI or pi; opt-in.
Since v1.9.1
Add your own provider by pointing at a JSON usage endpoint and mapping its fields to meters.
Good to know
Needs an endpoint reachable with a static token.
Since v1.14.0
Show GitHub Copilot's premium-request, Chat and Completions quotas.
Good to know
Uses the gh CLI's login (gh auth token) and an undocumented endpoint the VS Code extension calls.
Since v1.14.0
Find the AI tools already signed in on this machine and turn them on automatically.
Good to know
Checks local credentials only; never re-enables a vendor you set to enabled = false.
Since v1.14.0
Open a usage dashboard from a tray icon on Windows.
Since v1.14.0
Show your Ollama Cloud usage quotas.
Good to know
Needs a key from ollama.com/settings/keys; the local Ollama daemon has no quota data.
Since v1.18.1
Show the Grok Bot desktop app's weekly included usage.
Good to know
Reads the desktop app's own session; Linux only at this release.
Since v1.22.0
Show the 5-hour and weekly windows of an Alibaba Cloud Model Studio Token Plan.
Good to know
Needs bl auth login --console with the official bl CLI; opt-in.
Since v1.22.0
Get a desktop notification when a usage window crosses a threshold or a banked reset is about to expire.
Good to know
Linux notifications through notify-send; best-effort delivery.
Since v1.29.0
Before you upgrade
Newest first
v1.32.02026-10-04
On macOS the Claude Desktop and Claude Code switch submenus left the dropdown; use the Claude accounts section in Preferences.
Behavior changedAffects: macOS menu bar users who switched accounts from the dropdown
Meters and the run-out flame now allow up to 110% of the pace line before warning, and the Omarchy bar no longer turns red just because a refresh failed or is cached.
Behavior changedAffects: Users watching bar colors
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
The macOS menu bar and GNOME extension are now in English instead of Brazilian Portuguese; a vendor answering HTTP 429 is not polled again for five minutes.
Behavior changedAffects: macOS and GNOME users; anyone polling often
Labels now say Claude and Codex instead of Anthropic and OpenAI (ids stay anthropic and openai); config files with inline API keys are set to mode 0600 automatically, and the app stops if it cannot.
Behavior changedAffects: Users reading labels or keeping keys in config.toml
An invalid config now shows a warning in the widget and an error in the TUI instead of silently falling back to defaults, and cached data older than 7 days is no longer shown after a failed fetch.
Behavior changedAffects: Users with a broken config or long offline periods
On macOS, explicit credential paths (--creds-path, credentials_path, named accounts) no longer fall back to the Keychain, and a stale zeroed credentials file at the default path now does.
Behavior changedAffects: macOS users who set a credentials path
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.
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
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.
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…
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
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…
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
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
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.
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,…
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…
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…
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…
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
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…
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…
