Skip to content

Freeby 2.0.0 alpha 2 — Claude Code usage

Pre-release
Pre-release

Choose a tag to compare

View all tags
@oo7kc oo7kc released this 06 Sep 08:29
· 32 commits to dev since this release
v2.0.0-alpha.2
48b28ac

Alpha.2 adds Claude Code usage monitoring to the Codex foundation released in alpha.1.

Included

  • Claude Code installation and saved OAuth sign-in detection.
  • 5-hour, weekly, and model-scoped account quota windows.
  • Seven-day local transcript activity and per-model input, output, cache-read, and cache-write totals.
  • Duplicate-message protection and SHA-256 session identifiers in private XDG caches.
  • Independent local-history results when authentication expires or Anthropic usage checks fail.
  • Expired stale quota windows are removed after their reset.

Install or upgrade

gnome-extensions install --force freeby@kelvin.local-2.0.0-alpha.2.zip
gnome-extensions enable freeby@kelvin.local

Log out and back in if GNOME Shell has not discovered the updated extension.

Verification

  • CI passed on the tagged dev commit with 20 unit tests, GJS Codex/Claude history integration tests, strict schema checks, an isolated Meson install, and deterministic packaging.
  • The exact ZIP loaded, disabled, and re-enabled in a private GNOME Shell 50 session.
  • Claude Code 2.1.218 detection and the missing-auth path were exercised locally.
  • Quota shapes, expired auth, response errors, duplicate messages, and cache-token semantics were fixture-tested against the current upstream interface.

Known limitations

  • No signed-in Claude account was available on the development machine, so the authenticated usage endpoint path is fixture/upstream-validated rather than live-account-validated.
  • GNOME Shell 50 remains the only desktop version verified for this prerelease.
  • Activity history is local to this device and separate from subscription quota usage.
  • Cursor and Copilot remain opt-in previews until alpha.3 and alpha.4.
  • Cost and billing features remain deferred.

Downgrade

Install the alpha.1 or v1.0.2 archive with gnome-extensions install --force, then restart the session. Freeby's derived XDG cache/state data can be removed independently; it never owns provider credentials or transcripts.

Assets 3
Loading