v0.2.1

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 autoRefreshLogin setting, 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-cleanup teardown 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).
• wwwroot now always copies on build — stops a stale UI from shipping.
• Removed a redundant phone-access toggle.

Full changelog: v0.2.0...v0.2.1

v0.2.0

Claude Usage Desktop v0.2.0 — a substantial feature release focused on auth resilience, the new cumulative Stats page, and connection robustness.

🔐 Auth resilience

• Disk-token adoption is now the primary refresh path. When the host Claude Code refreshes its OAuth token on disk, the app adopts that token instead of performing its own network refresh — so it never competes with claude for the rate-limited token endpoint.
• Sticky multi-hour cooldown for no-Retry-After token-endpoint 429s. Fixes a self-inflicted rate-limit loop: the old 60-minute-capped backoff expired inside the server's still-open penalty window and re-armed it every cycle. A 429 without Retry-After now triggers a 4h→12h sticky cooldown; Retry-After, when present, is still honoured.
• Last-known data shown dimmed on auth failure instead of a blank page.
• Dedicated auth-refresh.log capturing the full token-refresh lifecycle (the standard logger has no providers in Release builds).

📊 Stats page

• Cumulative usage graph with 1d / 7d / 30d ranges and step-after lines.
• True-percentage dual axes — distinct Session/Week colours with a dashed Week key.
• Per-bar captions, a projected "time without service" readout, and four-tier projection colour thresholds.

🛡️ Robustness

• SignalR auto-reconnect + CDN-unreachable guard — the toolbar no longer dies on a phone that can't reach the CDN.
• Smarter host-IP selection that excludes USB-tether and VirtualBox adapters.
• Asset cache-buster (?v=VERSION) so a new build reliably refreshes the browser client; favicon added.
• wwwroot now copied Always (not PreserveNewest) so edits can't ship a stale UI over the unreliable shared-folder timestamps.

---

Windows x64, self-contained — no .NET install required. Download ClaudeUsage-v0.2.0-win-x64.zip, extract the whole folder, and run ClaudeUsage.exe.

v0.1.18

Claude Usage Desktop v0.1.18

A big quality-of-life release: usage history now persists and is visualised, the LAN/remote experience survives network blips, and a raft of OAuth/token-refresh and tray-icon reliability fixes land.

Highlights

• Stats page + cumulative usage logger. Usage is now recorded over time and surfaced on a dedicated stats view, so you can see consumption trends instead of just the current window.
• Normalised dual-axis cumulative graph. The cumulative chart now plots Session and Week on independent, auto-fit axes (each scaled to its own window max) so both lines always use the full plot height. Step-after lines reflect the real integer-% transitions, Session and Week have distinct colours, and the Week key is a dashed line to match its series.
• LAN / SignalR auto-reconnect resilience. The browser/remote view now shows a "Reconnecting…" indicator and recovers automatically after a dropped connection instead of going silently stale.
• Smarter host-IP selection. The advertised LAN address now skips USB-tether/RNDIS and VirtualBox host-only adapters (including the 192.168.56.x subnet), so the QR/URL points at the real network interface.
• Honest dynamic-axis usage bars. Usage bars scale to a real, data-driven axis instead of a misleading fixed projection.
• Unified in-page About modal. The About box is now a single consistent in-page modal driven by the app slug.

Reliability fixes

• Token-refresh cooldown / back-off. Added a refresh cooldown on 429 from the token endpoint to stop a self-inflicted refresh lockout, plus exponential backoff with a visible backoff status card.
• Automatic OAuth token refresh (proactive + reactive), with the refresh endpoint corrected and the full refresh lifecycle instrumented to a dedicated auth-refresh log file for field debugging.
• Stale-data-on-auth-failure. On an auth failure the app now shows the last-known good data (clearly) rather than blanking out, and serves assets with a cache-buster.
• Window-close no longer kills the server. Closing or hiding the window keeps Kestrel and the background poller running until you explicitly Quit from the tray.
• Tray-icon fixes for the single-file published build (icon was invisible / set too early during construction).
• Single-instance guard so a second launch focuses the running app instead of fighting over the port.
• Fixed a first-load JS crash (connection TDZ bug), stats-view height on landscape viewports, a multi-view navigation bug, and wwwroot not publishing alongside the single-file exe.

Install

Download ClaudeUsage-v0.1.18-win-x64.zip, extract the whole folder, and run ClaudeUsage.exe. It's a self-contained Windows x64 build — no .NET install required. (Keep the extracted files together; the exe needs the wwwroot and WebView2 files beside it.)

v0.1.7

Handle expired/resetting window state: no more frozen 0h 00m 00s countdown or bogus 100% spare ratio when a window has ended. Shows "resetting..." in the timer and "Window ended" in place of the ratio. Wording kept neutral as the exact reset trigger (scheduled vs. activity-based) could not be verified from the app code.

v0.1.6

Fixed over-limit hatch left-edge alignment on the actual bar: the cross-hatched zone now starts exactly at the 100% marker and extends to the track's right edge (aligned with the right end of the prediction bar). Previous versions used a CSS background-position percentage that mistakenly centred the hatch on the 100% mark.

v0.1.5

Fixed over-limit hatch alignment on the actual bar: the cross-hatched zone now correctly spans from the 100% mark to the right end of the prediction bar on all four cards.

v0.1.4

Over-limit zone on prediction bars is now cross-hatched red -- the area to the right of the 100% marker shows diagonal red hatch lines when a projection exceeds the limit, making the danger zone immediately visible.

v0.1.3

• App icon: rounded square icon embedded in exe, window title bar, and taskbar
• Overflow-mark: changed from white to red to distinguish the 100%-limit marker from the white elapsed-time line

v0.1.2 - Claude Usage Desktop (Windows)

What's new in v0.1.2

In-app update check -- On startup the app checks the GitHub releases API. If a newer version exists, a slim notice appears at the top of the UI with a link to the release page. The check is silent on failure (no network, GitHub outage) and never blocks startup.

---

See v0.1.0 release notes for installation instructions and caveats.

Claude Code must be running on the same machine. This app reads Claude Code's local credentials and usage data and cannot fetch usage remotely.

v0.1.1 - Claude Usage Desktop (Windows)

What's new in v0.1.1

Weekly rounding warning -- The usage API reports whole-integer percentages. Near the end of the weekly period, if the projection is >=90%, a small caution note appears below the Week bars explaining that actual usage could be slightly higher than shown -- useful when you're right on the edge of the cap.

Brighter reset countdowns -- The "4h 17m 51s" countdown next to each card label is now the same brightness as the label text.

Spare-ratio fix for zero usage -- When projected usage is effectively 0%, the spare ratio now shows "∞ until usage not 0%" (green) instead of the misleading ~101% the formula produced. For large-but-finite values (>500%), the ratio is shown as a multiplier (e.g. 9.9x).

---

See v0.1.0 release notes for installation instructions and caveats.

Claude Code must be running on the same machine. This app reads Claude Code's local credentials and usage data and cannot fetch usage remotely.