Release / 18 Oct 2026 / 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

ai-usagebar v1.41.0

Track ClinePass subscription limits alongside your other AI plans.

All of ai-usagebar

Before you upgrade to v1.41.0

2 to fix

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 requiredSee how many live Claude Code sessions are working or waiting for input.Affects: Users who redirected the v1.33.0 default Claude tooltip activity line with CLAUDE_CONFIG_DIR

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.34.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 changedCheck every enabled vendor's usage in a tabbed terminal app, without Waybar.Affects: Users with [ui] overview_vendors configured and consumers rendering report entries in order

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.36.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 changedShow Google Antigravity's 5-hour and weekly quotas for both model pools.Affects: Antigravity users relying on fallback quota collection

Read the evidence

Critical Linux quota alerts request a 30-second timeout. They expire where the notification daemon honors it; Omarchy's plugin still ignores that timeout pending its own change.

Behavior changedGet a desktop notification when a usage window crosses a threshold or a banked reset is about to expire.Affects: Linux users receiving exhausted-quota notifications

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.41.0

Spend cards and tooltips name the last fully covered UTC day because the cost endpoint returns completed daily buckets and can omit today's activity.

Behavior changedShow your Anthropic API organization's spend for the current month, against a limit you set.Affects: Anthropic API spend users

Read the evidence

akitaonrails/ai-usagebar/releases/tag/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

akitaonrails/ai-usagebar/releases/tag/v1.35.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

akitaonrails/ai-usagebar/releases/tag/v1.34.0

What changed in v1.41.0

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.

New things you can do

Enable `[devin]`; macOS daily and weekly quota parsing works from v1.34.0.

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

Read the evidence

Enable `[cline]`; macOS parses all three windows from v1.37.0, and renamed `api_key_env` credentials reach the provider catalog from v1.38.1.

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

Read the evidence

Enable `[muse-code]`; elapsed and pace placeholders work from v1.38.1, and transient cold-cache network failures show loading.

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

Read the evidence

Enable `[synthetic]`; the macOS menu bar displays its quota from v1.40.1.

AddedTrack Synthetic subscription request usage, allowance and renewal.

Read the evidence

`usage --json` adds `activity` and an Activity row; v1.34.0 makes the tooltip follow the displayed account and share report filtering.

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

Read the evidence

The card's Prepare action checks live quota, runs one short turn if needed, and confirms readiness from the server reset time without restarting Desktop.

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

Read the evidence

Fixed and improved

Watch several logins with `[[copilot.accounts]]` and `--account <label>`, each with its own tab and cache; `show_default_account = false` hides the unnamed entry. `GITHUB_COPILOT_TOKEN` cannot be combined with `--account`.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.34.0

Read the official CLI's existing `auth.json` after `opencode auth login`; `OPENCODE_GO_API_KEY` or an explicit `api_key` still wins. Override the file with `auth_paths`.

ImprovedShow your OpenCode Go rolling, weekly and monthly usage.

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.35.0

Credit-based Pro plans show included and purchased credits, monthly utilization and billing resets through `/api/balance`; legacy session/weekly quota plans remain supported.

Now worksShow your Ollama Cloud usage quotas.

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.35.0

Read the monthly Token Plan window, including monthly-only plans, in the widget, TUI and reports; the macOS menu bar handles monthly-only plans from v1.38.1.

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

Read the evidence

Set `[nous] headline = "amount"` for usable credits on supported report-driven panels; a drained allocation no longer fails on tiny negative rounding residue. Credit detail lines, tooltips and balance placeholders format as USD from v1.41.0.

ImprovedShow your Nous Research subscription usage.

Read the evidence

The macOS menu bar displays DeepInfra's USD balance instead of leaving it blank.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.33.0

Switch a saved Desktop-only account from its macOS tray card with a second confirmation click; `/claude-account` in the supplied Claude Code mod lists quotas and switches Desktop after a dry run. The tray can also add Claude and Codex accounts.

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

Read the evidence

Choose per-account visible metrics, Used/Left reading and provider logos; Antigravity has separate pool buttons. Hidden metrics leave the bar, tooltip and alert calculation; at least one remains. Panel languages add Korean and Spanish.

ImprovedShow your AI usage in Omarchy's Quattro bar as a native plugin, with a panel and settings.

Read the evidence

Settings lists every provider with enable and sign-in controls, including disabled ones; Windows hover text follows starred metrics. Choose 15, 30 or 60-minute refreshes, view Cursor On-Demand caps as bars and see stale-data age. Spanish is available.

ImprovedOpen a usage dashboard from a tray icon on Windows.

Read the evidence

The macOS global-shortcut recorder captures chords; providers enabled after first launch gain default menu-bar stars, explicit unstarring survives restart, and missing cards keep their order and customization when they return.

Now worksOpen a usage dashboard from a tray icon on Windows.

Read the evidence

Hide individual metrics per provider in Configure; hidden rows leave the popup, panel, tooltip, headline and severity, while the last visible metric stays locked. Value headlines display amounts, and grouped session rows no longer displace quota cells or color cards.

ImprovedShow every provider's usage in a KDE Plasma 6 panel widget.

Read the evidence

Select several Top bar vendors side by side with brand icons, or switch all off to hide them. Optional `show-pace` arrows color and annotate percentages when bars are off; an existing single `vendor` id remains valid.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.38.0

JSON adds optional `overview_vendors`, capped text-row `severity` and per-model `model_pool`; unstated or non-positive durations omit `window_secs` instead of emitting zero.

ImprovedPrint every vendor's usage and reset times in the terminal or as JSON.

Read the evidence

The Linux Mint dashboard opens under Wayland instead of crashing while asking for X11 server time.

Now worksOpen a usage dashboard from a tray icon on Windows.

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.36.0

Show per-model pools such as Gemini 4 Argon alongside shared windows without duplicate-bucket failures; macOS summaries prefer shared windows over model-only limits, and simultaneous `agy` sessions use the latest quota reading rather than the latest redraw.

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

Read the evidence

KDE keyring sessions work when `secret-tool lookup` rejects their content type; `agy` 1.3.1 missing-CSRF responses fall back correctly. Set `ide_language_server = false` to bypass a signed-out IDE masking a working session; this option has no effect on Windows.

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

Read the evidence

The TUI and usage reports show the overall quota's reset countdown, with pace for weekly periods.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.38.0

Set a three-letter uppercase `currency` on `[[custom.metrics]]` or `[[custom.texts]]` to format numeric footnotes and rows as money; currency metrics use `used` and `limit`, not a ready-made `percent`.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.41.0

Extra-usage spend remains visible when credits or the monthly limit run out, distinguishing provider-disabled credit exhaustion from a user-disabled setting.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.41.0

API-controlled plan, model, credit-balance and Ollama text are escaped so `&` or `<` no longer breaks Waybar markup.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.35.0

Blank Claude tokens report a credentials error and login hint without sending an invalid request or arming rate-limit backoff, so logging back in is not masked by a five-minute wait.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.34.0

Blank Codex tokens report a credentials error with `codex login` instead of a false rate limit; empty refresh tokens no longer trigger invalid refresh requests.

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

Read the evidence

akitaonrails/ai-usagebar/releases/tag/v1.34.0

Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.

Before you upgrade to 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.

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.

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.

`[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`.

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.

Critical Linux quota alerts request a 30-second timeout. They expire where the notification daemon honors it; Omarchy's plugin still ignores that timeout pending its own change.

Spend cards and tooltips name the last fully covered UTC day because the cost endpoint returns completed daily buckets and can omit today's activity.

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.

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.

What changed in v1.41.0

New things you can do

Enable `[devin]`; macOS daily and weekly quota parsing works from v1.34.0.

Enable `[cline]`; macOS parses all three windows from v1.37.0, and renamed `api_key_env` credentials reach the provider catalog from v1.38.1.

Enable `[muse-code]`; elapsed and pace placeholders work from v1.38.1, and transient cold-cache network failures show loading.

Enable `[synthetic]`; the macOS menu bar displays its quota from v1.40.1.

`usage --json` adds `activity` and an Activity row; v1.34.0 makes the tooltip follow the displayed account and share report filtering.

The card's Prepare action checks live quota, runs one short turn if needed, and confirms readiness from the server reset time without restarting Desktop.

Fixed and improved

Watch several logins with `[[copilot.accounts]]` and `--account <label>`, each with its own tab and cache; `show_default_account = false` hides the unnamed entry. `GITHUB_COPILOT_TOKEN` cannot be combined with `--account`.

Read the official CLI's existing `auth.json` after `opencode auth login`; `OPENCODE_GO_API_KEY` or an explicit `api_key` still wins. Override the file with `auth_paths`.

Credit-based Pro plans show included and purchased credits, monthly utilization and billing resets through `/api/balance`; legacy session/weekly quota plans remain supported.

Read the monthly Token Plan window, including monthly-only plans, in the widget, TUI and reports; the macOS menu bar handles monthly-only plans from v1.38.1.

Set `[nous] headline = "amount"` for usable credits on supported report-driven panels; a drained allocation no longer fails on tiny negative rounding residue. Credit detail lines, tooltips and balance placeholders format as USD from v1.41.0.

The macOS menu bar displays DeepInfra's USD balance instead of leaving it blank.

Switch a saved Desktop-only account from its macOS tray card with a second confirmation click; `/claude-account` in the supplied Claude Code mod lists quotas and switches Desktop after a dry run. The tray can also add Claude and Codex accounts.

Choose per-account visible metrics, Used/Left reading and provider logos; Antigravity has separate pool buttons. Hidden metrics leave the bar, tooltip and alert calculation; at least one remains. Panel languages add Korean and Spanish.

Settings lists every provider with enable and sign-in controls, including disabled ones; Windows hover text follows starred metrics. Choose 15, 30 or 60-minute refreshes, view Cursor On-Demand caps as bars and see stale-data age. Spanish is available.

The macOS global-shortcut recorder captures chords; providers enabled after first launch gain default menu-bar stars, explicit unstarring survives restart, and missing cards keep their order and customization when they return.

Hide individual metrics per provider in Configure; hidden rows leave the popup, panel, tooltip, headline and severity, while the last visible metric stays locked. Value headlines display amounts, and grouped session rows no longer displace quota cells or color cards.

Select several Top bar vendors side by side with brand icons, or switch all off to hide them. Optional `show-pace` arrows color and annotate percentages when bars are off; an existing single `vendor` id remains valid.

JSON adds optional `overview_vendors`, capped text-row `severity` and per-model `model_pool`; unstated or non-positive durations omit `window_secs` instead of emitting zero.

The Linux Mint dashboard opens under Wayland instead of crashing while asking for X11 server time.

Show per-model pools such as Gemini 4 Argon alongside shared windows without duplicate-bucket failures; macOS summaries prefer shared windows over model-only limits, and simultaneous `agy` sessions use the latest quota reading rather than the latest redraw.

KDE keyring sessions work when `secret-tool lookup` rejects their content type; `agy` 1.3.1 missing-CSRF responses fall back correctly. Set `ide_language_server = false` to bypass a signed-out IDE masking a working session; this option has no effect on Windows.

The TUI and usage reports show the overall quota's reset countdown, with pace for weekly periods.

Set a three-letter uppercase `currency` on `[[custom.metrics]]` or `[[custom.texts]]` to format numeric footnotes and rows as money; currency metrics use `used` and `limit`, not a ready-made `percent`.

Extra-usage spend remains visible when credits or the monthly limit run out, distinguishing provider-disabled credit exhaustion from a user-disabled setting.

API-controlled plan, model, credit-balance and Ollama text are escaped so `&` or `<` no longer breaks Waybar markup.

Blank Claude tokens report a credentials error and login hint without sending an invalid request or arming rate-limit backoff, so logging back in is not masked by a five-minute wait.

Blank Codex tokens report a credentials error with `codex login` instead of a false rate limit; empty refresh tokens no longer trigger invalid refresh requests.