Release / / 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
ai-usagebar v1.51.0
Choose which AI plan to use before its weekly quota resets unused.
Share
Before you upgrade to v1.51.0
3 to fixTabs show logos only by default; `tabNames` restores names. Panel meters show an even-burn pace tick by default; disable `paceMarker` to hide it.
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.
Read the evidence
The popover closes on an outside mouse click, but stays open when another app activates itself or a keyboard switch changes focus.
Read the evidence
An existing `agy` reading stays stale if the CLI cannot answer, rather than being replaced by Cloud Code's quota; CLI timeout rises to 90 seconds. HTTP 401/403 authentication rejection instead surfaces an error without stale quota.
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.
Read the evidence
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.
Read the evidence
Synthetic meters show remaining allowance regardless of the global reading setting; set `[synthetic] plan_tier` to label the plan. Panels and alerts describe partial regeneration rather than a full reset.
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.
Read the evidence
Prepare sends no turn for verified Ultra accounts without a five-hour limit.
Read the evidence
Concurrent configuration saves wait for each other; after five seconds of contention, saving fails with a retry message instead of overwriting another process's edits.
Read the evidence
API keys echoed by providers are redacted before cache writes or display in reports, the widget and CLI; non-JSON responses echoing the key are not persisted.
Read the evidence
What changed in v1.51.0
`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.
New things you can do
Run `ai-usagebar mcp` for read-only `get_usage` and `list_providers`, optionally narrowed to a provider or account.
Read the evidence
Enable `[droid]`; tagged code defaults `cli_renewal` to false. Set it true to let `droid doctor --checks auth` renew an expiring login, or run `droid` yourself.
Shows input/output meters, dollar ceiling and included searches; wallet failures keep matching cached balances stale, including rejected keys.
Set `MISTRAL_API_KEY` or `[mistral] api_key`; budgets use the response currency without pacing markers, and matching cached budgets survive 401/403 as stale.
Use `usage --json --priorities` for `ranking` and `recommendation`; tune with `--recent-hours`, `--alert-unused-percent` and `--alert-hours`. Expired windows are excluded.
Use the card header's copy button or its Copy as Image context-menu item.
Read the evidence
Fixed and improved
Enable Priorities in Settings for ranked providers, forecast details and urgent unused-quota alerts; `p` opens the view. Hidden bar providers neither alert nor get recommended on the bar.
Read the evidence
Hide providers or named accounts from the bar while keeping them in the panel; scroll and middle-click skip hidden entries. `reportBinary` and `tuiBinary` select local binaries; errors offer copyable fixes and retry actions.
Panel colors and live theme changes work on Qt 6.12.
Read the evidence
Browse a tabbed usage panel with plan, meters, reset times and refresh controls; pin SuperGrok or OpenCode Go in the top bar. Supports GNOME Shell 51 and opening commands in Ptyxis.
The widget loads without QML syntax errors; with an absolute Binary path, panel and middle-click launches find the neighboring `ai-usagebar-tui` even when it is off `PATH`.
Hide and reorder providers across popup tabs, cards and the scroll ring; provider brand marks identify tabs and cards.
Read the evidence
Linux Mint's status icon shows the leading provider's percentage and a usage tooltip; balance-only providers leave the percentage blank.
Read the evidence
Enter and validate API keys in the popover, or sign in to Codex, Kimi and Nous with device codes. Failed key checks restore prior keys and enabled state, including inline TOML tables.
Select App Icon mode to keep a gauge in the menu bar without clearing starred metrics.
Read the evidence
Configure `[[devin.accounts]]` for separate tabs, cards and caches; select one with `--vendor devin --account <label>`.
Read the evidence
Show on-demand spend or caps as Additional usage in the tooltip, TUI and JSON; `{sgk_on_demand}` exposes it. An all-zero pair stays hidden.
Read the evidence
Read OpenCode 2's SQLite login, preferring `opencode-go` over the legacy row; explicit keys and `auth.json` retain precedence. `auth_paths` accepts `~` paths.
API-key refreshes honor cache TTL and rate-limit backoff instead of calling identity on every poll.
Read the evidence
Reports explicitly show zero reset credits as None available and missing weekly or five-hour windows as Not reported.
Reads the regenerating weekly budget instead of the retired request counter; shows precise percentages, credits where supplied and partial-refill countdowns. Old cache data is refetched.
Read the evidence
Synthetic alerts no longer repeat on every refill tick; they re-arm after usage drops seven points below threshold. Banked-credit expiry reminders now identify named accounts.
Reads Cursor 3.27.12's opaque IDE token using its cached profile; on HTTP 401 retries a separately signed-in `cursor-agent`. JWT logins remain authoritative and 403 does not switch sessions.
Copilot Free skips zero-entitlement buckets and displays chat or completions when premium requests are absent. A stalled `gh auth token` no longer freezes the TUI and times out after five seconds.
Show cloud session credits, prepaid usage-credit balance and auto-reload state when reported; missing balances remain absent.
Read the evidence
Usage requests identify a current Claude CLI version, avoiding authentication errors caused by the server rejecting the old client version.
Read the evidence
A live macOS CLI account with Keychain-only credentials reads its scoped Keychain item instead of another default login. Locked or denied items report the error rather than falling back.
Read the evidence
`account add --desktop` captures Desktop 4.16 V2-only logins without timing out; switching avoids importing the outgoing legacy token. Captured accounts appear in usage tabs and account lists.
The spend row keeps a stable name, preserving stars, hidden rows and notification state across days; coverage date moves to Through. An active 429 wait survives month rollover.
Add `[[anthropic_api.accounts]]` for separate Console organizations and per-account `monthly_limit`; macOS Preferences and Switch Provider honor named accounts and `show_default_account` from v1.51.0.
Newer-shape accounts show monthly quotas on the default bar and macOS menu bar; accounts without a rolling limit omit the false five-hour zero and leave session placeholders empty.
Read and refresh Google and GitHub social logins alongside AWS sessions, selecting the valid session with the newer expiry.
Read the evidence
Text reports align columns using terminal display widths, including CJK and combining characters; wide values move to details. The JSON format is unchanged by this alignment fix.
Read the evidence
Generic `{icon}` uses each built-in provider's own mark or short name; Grok Bot's missing session placeholders expand empty instead of printing literally.
Editing keys, toggles and scalar settings works with TOML inline tables, including removing saved keys; Nous credential-lock waits leave input and other requests responsive.
Expired or rejected cache data no longer bypasses active 429 backoff for Cursor, Kiro, SuperGrok, Synthetic and Antigravity's remote fallback.
Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.