v0.1.0
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 info → Run anyway. Code signing planned for v0.2+.
Setup
- Install the AI-Usage_Tracker extension v0.2.0+ (Chrome / Edge / Brave / Firefox).
- Run the QuotaGlass installer.
- Reload the extension in
chrome://extensions/. - Visit
claude.ai/settings/usageorchatgpt.com/codex/cloud/settings/analyticsonce to prime the data. - The widget renders bucket cards within seconds.
What's in v0.1.0
- Glass widget — borderless, always-on-top with
WinEventforeground-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.