A small WPF widget that sits in the Windows taskbar and shows your current Claude AI (and Codex) usage — 5-hour session limit and 7-day rolling limit. Supports multiple accounts side by side.
Requires .NET 8 Desktop Runtime (x64 or ARM64).
Appears in the bottom-right corner of every monitor, next to the system tray.
- Download
ClaudeUsageWidget-win-x64.exe(orwin-arm64) from Releases - Place the exe anywhere (e.g.
C:\Tools\ClaudeUsageWidget.exe) - Run it — the widget appears in the bottom-right corner of each monitor, next to the system tray
- Right-click → Run at startup to launch it automatically on login
The widget looks for credentials in the following locations and shows one panel per unique account:
Claude:
- WSL —
~/.claude/.credentials.json(viawsl.exe) — preferred - Windows —
%USERPROFILE%\.claude\.credentials.json— fallback
Accounts with the same org ID are deduplicated (one panel shown).
Codex:
- WSL —
~/.codex/auth.json - Windows —
%USERPROFILE%\.codex\auth.json
Credentials are generated by Claude Code CLI / Codex CLI when you log in. If you have the CLI installed in WSL, those credentials take priority.
Each account is shown as a separate column with a service icon (orange C for Claude, blue X for Codex) and two progress bars (5h + 7d). The widget width adjusts dynamically based on the number of accounts.
Hovering over a panel shows a tooltip with:
- Time until the 5h and 7d limits reset (countdown on the left, date on the right)
- Two sparkline charts (5h and 7d utilization) showing the last 14 days of usage history
Usage data is fetched by calling api.anthropic.com/v1/messages with a minimal request. The rate limit data is returned in the response headers:
anthropic-ratelimit-unified-5h-utilizationanthropic-ratelimit-unified-7d-utilizationanthropic-ratelimit-unified-5h-resetanthropic-ratelimit-unified-7d-reset
Progress bar color: green (< 75%), orange (75–90%), red (≥ 90%).
If the API call fails, both bars turn dark red (maroon) and show "Error". The widget auto-retries every minute.
Usage data is stored locally in %APPDATA%\ClaudeUsageWidget\history\ as JSON files (one per account). Data is saved after every successful API call in 10-minute buckets and trimmed automatically to 14 days.
The widget automatically hides when:
- The taskbar is set to auto-hide and slides down
- A fullscreen application is running on the same monitor
It reappears when the taskbar comes back or the fullscreen app is closed.
Note: This is not a native Windows widget (Win+W panel). It is a standalone borderless WPF window that pins itself to the taskbar next to the system tray and stays always on top. The reason: the native widget API requires an MSIX package and COM registration, which needs Developer Mode enabled and a complicated install process.
Requires .NET 8 SDK.
make run # dotnet run (Debug — Run at startup is grayed out)
make build # dotnet buildSolution: ClaudeUsageWidget.sln