Unofficial native Windows tray monitor for Claude Code usage — a crisp DPI-aware icon shows your rate-limit %, projects when you'll run out, turns red before the limit, and celebrates quota resets wit
Claude Code Tray is an unofficial, community-built Windows system-tray monitor for your Claude Code rate-limit usage. It draws a crisp, DPI-aware vector icon showing the current usage percentage with a Task Manager-style fill bar, and projects when you'll hit 100% — a proportional pace line for the weekly window and a burn-rate regression for the 5h session and extra windows — turning the bar vivid red when you're on track to run out before the window resets. Switch which window the icon tracks (session 5h, week 7d, or extra) from the right-click menu. When a window hands your quota back, a bespoke color-coded toast slides up to announce it: Surprise! (early weekly reset), Bonus! (mid-window credit), New week!, and Fresh session! — each toggleable in Settings. A Usage insights (24h) submenu shows a local, price-weighted breakdown of your usage (from subagents, large-context share, and a by-model split) computed from your own Claude Code session transcripts — no extra API calls and never reading message content. The app reuses the OAuth token Claude Code already stores, so there is nothing to configure, and it self-updates from GitHub Releases.
What's new in 1.8.0
What's new in v1.8.0
One new notification, plus a window that fits smaller screens.
🔴 A warning before a limit runs out
The icon has always turned red when your pace would use up a window before it resets. That only helps if you happen to look at the tray. Now a red toast says it once, titled *On pace to run out*. It tells you how long until the window runs out at this pace and when it resets.
Once per window, per reset. The 5-hour session and the weekly window each get at most one warning per cycle. It does not repeat every poll, and restarting the tray mid-cycle does not send it again.
The same verdict as the icon. The toast and the red bar use the same pace line, so you never get a toast without the red icon, or a red icon without the toast.
Quiet when it would be noise. No warning in the first tenth of a window, when a pace has nothing behind it yet. No warning for a window that has already hit its limit either, because the icon already says it is blocked.
On by default, under Settings → Notifications → On pace to run out. Unlike the reset toasts, this one is plain red, with no confetti.
🖥️ Fits smaller screens
The window fits screens shorter than 960 pixels, down to 720p. On a short screen it now opens sized and centred to the work area instead of running off the bottom of the screen.
The Statistics charts size to the window. The pace and throughput charts grow with a tall window and shrink with a short one, down to a minimum height. Below that the page scrolls, so the axis labels are never clipped.
🔬 Under the hood
Nothing here changes what the app does. It changes what can ship broken.
The UI checks drive the real window. The 3,004-line interaction harness is gone. Every claim it made is now a case run by winwright：keyboard input under the tray's own message loop, the right-click menu, the profile switch, the linking plan, the session rows and what each control announces to a screen reader.
Previews are drawn by the app, not copied off the screen, so nothing on top of the window can end up in a screenshot, and a popup can be photographed at all.
The local release script says it did not submit to winget, and how to submit it, instead of looking like it had.
Yes. Claude Code Tray (unofficial) is free and open-source software released under the Apache-2.0 license.
What is the latest version of Claude Code Tray (unofficial)?
The latest version is 1.8.0, released on Oct 20, 2026.
Is it safe to download Claude Code Tray (unofficial)?
The download button links to the official installer published on github.com, the same file Windows Package Manager installs. You can verify the downloaded file by comparing its SHA-256 checksum with ac1a3e66e6582fad1f3d2c6673da7aee39097541fe5f4804a780d61236475d5d.
Which Windows versions does Claude Code Tray (unofficial) support?
Claude Code Tray (unofficial) runs on Windows and is available for 64-bit (x64) systems.
How do I install Claude Code Tray (unofficial) silently?
Run the offline installer with "ClaudeTray-Setup.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP-, or install it with Windows Package Manager: winget install --id=alegauss.ClaudeCodeTray -e --silent.
How do I uninstall Claude Code Tray (unofficial)?
Open Settings › Apps › Installed apps, find Claude Code Tray (unofficial) and select Uninstall. From the command line, run winget uninstall --id=alegauss.ClaudeCodeTray -e.
