Skip to content

UsageBeam 2.0.0 alpha 3

Latest
Latest

Choose a tag to compare

View all tags
@oo7kc oo7kc released this 09 Sep 09:32
· 1 commit to main since this release
v2.0.0-alpha.3
76db4ff

UsageBeam brings private, at-a-glance Codex and Claude Code usage monitoring to the GNOME top panel.

Highlights

  • Introduces the permanent UsageBeam product identity and extension UUID.
  • Shows the active provider's shortest quota and reset countdown in a compact, fixed-width panel indicator.
  • Adds aligned account limits, a seven-day local activity chart, and per-model token totals.
  • Supports left area, right area, left-of-calendar, and right-of-calendar placement.
  • Adds milestone notifications at configured, warning, and exhausted usage levels without duplicate alerts.
  • Improves caching, history recovery, provider discovery, privacy, and constrained-screen behavior.

Install

Download usagebeam@oo7kc.github.io-2.0.0-alpha.3.zip, then run:

gnome-extensions install ./usagebeam@oo7kc.github.io-2.0.0-alpha.3.zip
gnome-extensions enable usagebeam@oo7kc.github.io

Log out and back in after the first installation so GNOME Shell can discover the extension.

Upgrade

To replace an existing UsageBeam installation, install the ZIP with --force, then log out and back in:

gnome-extensions install --force ./usagebeam@oo7kc.github.io-2.0.0-alpha.3.zip

Recognized settings and derived data from older Freeby alpha builds migrate without copying credentials or overwriting existing UsageBeam data.

Verification

  • GitHub CI passed for release commit 76db4fff4308e2e2ae0cbbb68d108f93cd3bb0c7.
  • All 35 unit tests and the GJS integration suite passed.
  • All 15 history, notification, subprocess, and RPC stress cases passed.
  • The exact archive passed six isolated GNOME Shell environments, UI assertions, and 60 disable/re-enable cycles.
  • SHA-256: 1996bd638936cc58f51390bcf5525106bbd941f61f8efec933a85e0ddc8a2c90.

Known limitations

  • This prerelease supports GNOME Shell 50.
  • Local activity covers the current device and is not billing data.
  • Live limits require the corresponding installed provider CLI and a supported active sign-in.
  • Mixed-monitor hotplug, fractional scaling, non-English or RTL desktops, and live upstream failure modes remain outside the verified matrix.

Downgrade

Disable and uninstall UsageBeam before installing an earlier build. Alpha.1 and alpha.2 use the legacy Freeby UUID and separate settings, so they install as a different extension and do not consume UsageBeam's new state automatically.

Assets 4
Loading