Free Windows Tool

Monitor Claude Code Rate Limits
From Your System Tray

ClaudeTray shows your Claude Code usage like a battery meter — 5-hour and 7-day rate limits, color-coded, always visible. One click for a quick popup, right-click for a full local dashboard.

Download ClaudeTray.exe View on GitHub
FreeOpen SourceWindows 10 / 11100% Local

The Problem

If you use Claude Code heavily, you've hit the rate limit wall. One minute you're in the middle of a complex refactor, the next you're staring at a cooldown timer wondering how much capacity you've burned through. Claude Code shows the current status in the terminal, but if you're switching between projects or running multiple sessions, there's no persistent, at-a-glance indicator of where you stand.

ClaudeTray fixes that: your rate limit status lives in the Windows system tray, visible no matter what you're doing.

The Tray Icon

ClaudeTray tray icon showing Claude Code rate limit percentages

The tray icon shows your 5-hour and 7-day rate limit percentages, color-coded:

You can see it at a glance without switching windows or checking the terminal.

Quick Popup & Web Dashboard

ClaudeTray quick popup with usage bars

Click the tray icon for a compact popup: current usage bars for both windows, active session info, and recent projects. It's the "am I about to hit a wall?" check that takes half a second.

ClaudeTray local web dashboard with usage history charts

Right-click and open the full web dashboard for deeper stats:

Usage History Charts
See your consumption patterns over time across the 5-hour and 7-day windows.
Session Browser
Review past sessions — what you worked on and how much capacity each used.
Project Launcher
Jump back into recent projects straight from the dashboard.
100% Local
Runs on localhost port 5199 (configurable), stores everything in a local SQLite database. Nothing leaves your machine.

Auto-Detect — No Setup

ClaudeTray reads the statusline debug JSON that Claude Code emits. No API keys to configure, no manual setup. If Claude Code is running with the statusline hook, ClaudeTray picks it up automatically.

Install

Download ClaudeTray.exe from the latest release and run it. No installer needed. Or from source (Windows, Python 3.12+):

git clone https://github.com/VAROIndustries/ClaudeTray.git cd ClaudeTray pip install -r requirements.txt python -m claudetray

To launch at login, open Settings from the tray icon and enable Run on startup, or configure it in ~/.claudetray/settings.json.

FAQ

How do I check my Claude Code rate limits?
Claude Code shows your current status in the terminal, but there's no persistent, at-a-glance indicator if you're switching between projects or running multiple sessions. ClaudeTray puts your 5-hour and 7-day rate limit percentages in the Windows system tray — always visible, color-coded green, yellow, or red — so you can see where you stand without switching windows.
Does ClaudeTray need my API key?
No. ClaudeTray reads the statusline debug JSON that Claude Code emits — no API keys to configure and no manual setup. If Claude Code is running with the statusline hook, ClaudeTray picks it up automatically.
Is my Claude Code usage data sent anywhere?
No. The web dashboard runs locally on port 5199 (configurable) and stores everything in a local SQLite database. Nothing leaves your machine.
What do the tray icon colors mean?
Green means plenty of capacity, yellow means you're getting warm, and red means you're approaching or at the rate limit — for both the 5-hour and 7-day windows.
How do I install ClaudeTray?
Download ClaudeTray.exe from the latest GitHub release and run it — no installer needed. Or clone the repo and run it from source with Python 3.12+.

More Free Tools

PlainText
Strip clipboard formatting automatically — paste clean text every time.
KillSwitch
Kill every messaging, video, VPN, and social app in one click before you share your screen.
SpoolMedic
Fix a stuck print spooler in one click — no reboot, no services.msc.
All Apps & Tools →
The full VARØ suite — maker tools, developer utilities, vendor apps, and more.

Want the backstory? Read the ClaudeTray launch post on the blog.