Claude Usage Desktop v0.2.1 — a resilience and login-refresh release. The app now rides out network blips and keeps your Claude login fresh on its own, with a guided first-run setup and a proper installer.
Download ClaudeUsage-v0.2.1-win-x64.zip below, unzip anywhere, and run ClaudeUsage.exe.
Network resilience
- Distinct offline / network-changed state — a brief connection blip no longer drops the app into a long backoff.
- Network-change detection triggers an immediate re-probe and clears a stuck rate-limit cooldown (the connection that earned the penalty is gone, so the penalty no longer applies).
- New typed connectivity-state model driving calmer, more accurate status.
Automatic login refresh
- The app now keeps its own Claude login fresh: when the saved token nears expiry it asks the Claude CLI to refresh it. (The app's own direct token refresh is always rate-limited by the endpoint, so it delegates to the CLI, which refreshes reliably.)
- User-toggleable — new
autoRefreshLoginsetting, on by default, with a plain-language explainer; turn it off to refresh manually instead. - Calm auth banners that adapt to the current state (offline, refreshing, or login-needs-action).
Onboarding
- Guided phone-access setup flow — shown on first run, available any time from Settings, plus a dismissible home-screen card.
- The QR code appears only once phone access is enabled, so it never points at a closed port.
- Phone-access setup UI is hidden when viewed from the phone browser itself.
Reset / clear data
- New selective reset: clear settings, onboarding, caches, the firewall rule, autostart, or usage logs independently — usage logs are protected by default.
Installer
- New NSIS-based per-user installer and uninstaller: registers in Add/Remove Programs, shares a
--uninstall-cleanupteardown path, and preserves your data across upgrades.
Fixes & polish
- Removed dead disk-token-adoption code.
- Shows "No usage yet this period" at 0% usage instead of an empty bar.
- Stats graph: step lines, dual axes, and distinct series colours.
- Added a favicon.
- Guard against the SignalR CDN being unreachable (navigation keeps working on LAN/offline).
wwwrootnow always copies on build — stops a stale UI from shipping.- Removed a redundant phone-access toggle.
Full changelog: v0.2.0...v0.2.1