CLIProxyBar 0.4.4

CLIProxyBar 0.4.4 adds quota history, reset countdowns, and Claude plan badges:

• Quota usage graphs with session, weekly, monthly, and other windows on one 0–100% scale.
• Connected lines, a compact color legend, and hover values from recorded observations.
• Time ranges of 5 hours, 24 hours, 7 days, and 30 days, with gaps for missing observations.
• Separate Token history and Quota history tabs, with a stable header and shared card height.
• Token history as the initial default. The app remembers explicit tab choices across accounts and restarts.
• Optional reset countdowns for exhausted quotas in the menu bar and compact menu. Both settings start off.
• Claude Pro, Max 5×, and Max 20× badges from the OAuth profile through CLIProxyAPI.
• Updated README screenshots in light and dark mode, with fictional accounts and sample data.

Quota recording starts on by default and uses existing quota refreshes, without extra quota requests.
The app saves up to 30 days locally. Earlier quota history is unavailable from the current CLIProxyAPI endpoints.
Only timestamps, percentages, and hashed identifiers reach the quota history file.

Countdowns use reported future reset times. Missing reset times retain the percentage.
Quota usage that merely rounds to 100% does not trigger a countdown.
Claude profile lookups use a one-hour cache. Profile errors retain known plan labels and do not stop quota updates.

Tests cover graph gaps and hover readings, stable panel geometry, saved preferences, countdown selection, and Claude profile integration.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.
Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.4.3

CLIProxyBar 0.4.3 adds menu choices and OpenCode Go pace estimates:

• Independent provider visibility in the menu bar and drop-down, including plugin providers.
• Compact or expanded default view. Option-click opens the other view. Compact remains the initial default.
• Optional single percentage for the quota window closest to its limit. Paired percentages remain the initial default.
• OpenCode Go pace estimates for the five-hour rolling window and weekly quota.
• Monthly pace for OpenCode Go when the UTC billing cycle is unambiguous, with the actual month length.
• Gemini API-key accounts from Google AI Studio, with optional usage history. CLIProxyAPI currently supplies no allowance quotas for these keys.

Display choices survive relaunch. Hidden providers retain their quota refreshes, usage history, and alert settings.
The drop-down keeps the full quota breakdown after you select a single percentage for the menu bar.
If you hide every provider, Settings remains accessible.
CLIProxyBar keeps Gemini key values out of its account records and quota cache.

Tests cover display persistence, Option-click behavior, provider visibility, Gemini account discovery, and billing cycles across short months and leap years.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.4.2

CLIProxyBar 0.4.2 suppresses redundant reset alerts:

• Timed windows that already show 0% usage reset silently, without a notification or confetti.
• Reset alerts use the last reading before the deadline. Usage in a new window cannot trigger an alert for an unused window.
• Silent resets remain recorded after relaunch. Later resets of used windows still trigger alerts.
• Reset history from earlier versions remains compatible.

The reset tests cover session, weekly, and monthly limits, delayed confirmation, percentage rounding, and relaunch behavior.
Rolling alerts still require a full refill after usage.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.4.1

CLIProxyBar 0.4.1 improves generic provider quotas and daily activity:

• Provider names use backend metadata in menus and Settings. The provider selector scrolls when many providers are available.
• Plan labels support more subscription fields. Numeric summaries preserve units and use your locale for number and currency formats.
• Duplicate quota windows have distinct labels. Quota identities stay stable when the backend changes their order.
• Successful responses with no quota limits remain neutral. Cached readings, unavailable quotas, and failed requests have separate states.
• Failed requests preserve earlier readings. Cached accounts retain plan labels and empty responses after relaunch.
• Generic requests honor the account's quota provider override. Refresh results match the provider and credential identity.
• Pace indicators and reset alerts require known window behavior. Generic window labels alone do not establish reset behavior.
• Today has a thicker outline along the activity square's border. The outline preserves the activity color, and its legend stays hollow.

Response fixtures cover the generic quota contract. Claude, Codex and OpenCode Go passed live checks against a local CLIProxyAPI instance.
Antigravity and additional plugins still need live account validation.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.4.0

CLIProxyBar 0.4.0 adds provider discovery and broader quota support:

• Every configured provider can appear in the menu and optional usage history. Settings includes detected providers for menu bar indicators.
• Plugins with the generic quota capability share one adapter. It preserves quota groups, unfamiliar windows, reset times, plan labels, and numeric summaries.
• Antigravity has a direct adapter for quota summaries, with older per-model responses as a fallback.
• Unknown allowances stay unknown. Numeric summaries do not affect percentage gauges.

The new integrations use response fixtures and request tests. Antigravity and additional plugins still need live account validation.
Claude, Codex and OpenCode Go have live account checks. The notification crash fix from 0.3.3 remains included.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.3.3

CLIProxyBar 0.3.3 fixes a crash in quota reset notifications:

• The app could quit when macOS returned notification settings on a background queue. This affected reset alerts and opening Settings.
• Notification callbacks now handle background replies safely. Settings, reset detection, and alert preferences remain available after the update.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.3.2

CLIProxyBar 0.3.2 makes quota reset notifications more concise:

• Notifications hide account names that repeat the provider name. Distinct account names remain visible.
• Shorter reset messages identify the restored quota window.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.3.1

CLIProxyBar 0.3.1 adds configurable quota reset alerts:

• Settings has separate notifications for session/rolling resets and weekly/monthly resets.
• Weekly and monthly resets can play a short confetti animation, independently of notifications. A Preview button shows the effect.
• All options are off by default. macOS requests notification permission when you enable an alert.
• Fresh provider readings confirm scheduled resets. Rolling alerts wait for the allowance to become fully available again.
• Confirmed resets are remembered across launches. Limits that reset together produce one notification per account and one confetti animation.
• Confetti respects Reduce Motion, stays transparent, and does not intercept clicks or keyboard focus.
• CLIProxyBar refreshes at known reset times as well as during regular polling. The app must be running and connected.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.2.6

CLIProxyBar 0.2.6 refines the daily activity indicator:

• A thin ring inside the square identifies today.
• The Today legend is hollow. It identifies the current day without suggesting an activity level.
• Today's square keeps its recorded activity color, including zero usage.
• The ring adapts to light and dark mode and stays visible on pale squares.
• Usage totals use local calendar days consistently with the activity grid.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.

CLIProxyBar 0.2.5

CLIProxyBar 0.2.5 simplifies the usage card:

• The card starts with Today, Yesterday, and Last 30 days. The title, account email, and request-counter header are removed.
• Tokens and Requests change period totals, daily activity colors, and model totals.
• The model list sorts by the selected measure. The token breakdown stays visible in both modes.
• A small marker beneath the square identifies today. Its full color shows the activity level.
• The card keeps the same height when you switch measures. Clicks keep the menu open.

Versions before 0.2.4 need one manual or Homebrew upgrade to get the built-in updater.

CLIProxyAPI records request usage. CLIProxyBar collects these events and saves daily summaries locally while the app runs.
The usage queue retains events for about a minute. Closing the app or sleep can create gaps in recorded history.
Use one collector per proxy because retrieval removes events from the queue.

Requires macOS 14 or later and a CLIProxyAPI instance with management access.
OpenCode Go requires a plugin with native generic quota support.

This ZIP has an ad hoc signature and no Apple notarization.
If macOS blocks the downloaded app, open System Settings → Privacy & Security. Then select Open Anyway.