A Windows system tray app that shows your Claude.ai Pro/Max plan Opus-specific usage at a glance.
- Quick glance usage - Shows 5-hour session % remaining right in your system tray
- Color-coded status:
- 🟢 Green: >50% remaining
- 🟡 Yellow: 20-50% remaining
- 🔴 Red: <20% remaining
- Detailed tooltip - Hover to see session stats, weekly stats, and reset time
- Heartbeat auto-reset - Automatically pings Claude every 5 hours to keep the reset window cycling, even when idle. Maximizes your effective coding time by ensuring you're always mid-cycle when you sit down to work.
- Multiple accounts - Switch between different Claude accounts with independent heartbeat timers
- Auto-refresh - Configurable refresh interval (1, 5, 10, or 15 minutes)
- Auto-updates - Automatically notifies you when new versions are available
- Start on login - Optionally launch when Windows starts
- Easy login - Sign in via browser, no manual cookie copying
Download the latest installer from Releases:
- Setup exe - One-click installer with Start Menu & Desktop shortcuts
- Portable exe - No installation required, just run
git clone https://github.com/mattdotbuild/claude-usage-tray.git
cd claude-usage-tray
npm install
npm startTo build the installer:
npm run build- The app will open a browser window to claude.ai
- Sign in with your Claude account
- The app automatically captures your session - that's it!
- Shows your 5-hour session % remaining
- Color changes based on usage level
- Session usage % remaining/used
- Weekly usage % remaining/used
- Time until reset (e.g., "Resets in 2h 45m")
- Refresh - Manually update usage
- Accounts - Switch between accounts (if multiple)
- Settings - Open settings window
- Check for Updates - Manually check for app updates
- Exit - Close the app
- Show remaining percentage - Toggle between showing remaining vs used
- Refresh interval - How often to auto-update (1-15 minutes)
- Start on login - Launch automatically when Windows starts
- Heartbeat auto-reset - Toggle to keep the 5-hour reset window cycling across all accounts (see below)
- Accounts - Manage multiple Claude accounts
- Click an account to switch to it
- Click the name to rename it
- Click ✕ to remove it
- Click "Add Account" to add another
Claude's 5-hour usage window starts when you first send a message. With the heartbeat feature enabled, the app automatically sends a minimal ping to Claude every 5 hours to keep the window cycling in the background.
Why? If your 5-hour window resets at 8am and you start coding at 10am, you'd normally have a full 5 hours until your next reset. With heartbeat, the app would have already started a new window at 8am, so you're 2 hours into the cycle - meaning your next reset is only 3 hours away, giving you effectively 8 hours of coding time before you'd need to wait for a full reset.
- Works independently for each account
- Creates a temporary conversation, sends a tiny message, then deletes it
- Uses negligible tokens
- Disabled by default - enable in Settings > Heartbeat
This app uses Claude's web API to fetch your usage data. It requires a Claude Pro or Max subscription to show meaningful data.
API Endpoints used:
GET /api/organizations- Get your organization IDGET /api/organizations/{id}/usage- Get usage statistics
- Your session keys are stored locally in your user data folder (
%APPDATA%\claude-usage-tray) - Keys never leave your machine except to authenticate with claude.ai
- All connections use HTTPS
- No analytics or telemetry
The app automatically checks for updates on startup. When a new version is available:
- You'll see a dialog asking to download
- After downloading, you can restart to install
- Or manually check via right-click menu → "Check for Updates"
This is an unofficial tool and is not affiliated with Anthropic. It uses undocumented APIs that may change at any time. Use at your own risk.
MIT License - see LICENSE
PRs welcome! Please open an issue first to discuss major changes.
Inspired by Claude Usage Tracker for macOS.