Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 25 May 04:49
· 24 commits to main since this release

QuotaGlass v0.1.0 — first public release

Windows desktop widget for Claude + Codex quota tracking. Catppuccin Mocha glass card, radial-ring countdowns, custom-sound toast notifications, and a configurable alarm ladder so you never miss a renewal again.

Download

Architecture Installer Portable widget Portable NMH
x64 (most laptops/desktops) QuotaGlass-Setup-v0.1.0-x64.exe (5.9 MB) QuotaGlass-Widget-v0.1.0-win-x64.exe QuotaGlass-NMH-v0.1.0-win-x64.exe
ARM64 (Surface Pro X / Snapdragon-X) QuotaGlass-Setup-v0.1.0-arm64.exe (5.9 MB) QuotaGlass-Widget-v0.1.0-win-arm64.exe QuotaGlass-NMH-v0.1.0-win-arm64.exe

Recommended: the installer. It places binaries in %LOCALAPPDATA%\Programs\QuotaGlass\, registers the native messaging host for Chrome / Edge / Chromium / Firefox, drops a Start Menu shortcut with the proper AppUserModelID (required for toast grouping in Action Center), and optionally autostarts on login.

SmartScreen note: v0.1.x binaries are unsigned. Windows SmartScreen will prompt — click More infoRun anyway. Code signing planned for v0.2+.

Setup

  1. Install the AI-Usage_Tracker extension v0.2.0+ (Chrome / Edge / Brave / Firefox).
  2. Run the QuotaGlass installer.
  3. Reload the extension in chrome://extensions/.
  4. Visit claude.ai/settings/usage or chatgpt.com/codex/cloud/settings/analytics once to prime the data.
  5. The widget renders bucket cards within seconds.

What's in v0.1.0

  • Glass widget — borderless, always-on-top with WinEvent foreground-hook to re-assert TOPMOST through UAC and fullscreen.
  • Mica backdrop on Win11 22H2+; SolidColor fallback on Win10 1809+.
  • Per-bucket radial-ring countdowns with stale-state dimming.
  • Toast alarm ladder — 24h / 12h / 6h / 3h / 1h / 30m / 15m / 5m / at-reset, all toggleable.
  • Zero-state R3 — distinct toast when a bucket hits 100%.
  • U1 threshold alarms at 75/90/95%.
  • R2 renewal-arrived toast when a bucket resets.
  • Custom audio via SoundPlayer — drop in any WAV.
  • Fire-once idempotency — every alarm gates on <provider>-<bucket>-<rule>-<resetISO>.
  • System tray with worst-bucket badge icon, right-click menu, double-click toggle.
  • First-run Setup Checklist that probes extension install + NMH registration + first snapshot.
  • Embedded settings panel — refresh interval, alarm enable/ladder/thresholds, custom-sound picker, autostart toggle.
  • Click bucket card → open analytics page in default browser.
  • Pace footer — linear-extrapolation forecast when burning fast.
  • Self-hosted updater — checks GitHub Releases, downloads + self-replaces via PowerShell.

Privacy

Nothing leaves your machine. QuotaGlass only talks to the local AI-Usage_Tracker extension via stdin/stdout. No analytics, no telemetry. See the integration spec for the wire format.

License

MIT — see LICENSE.