Windows system tray app for real-time Claude AI usage monitoring
Get instant visibility into your Claude session and weekly usage, overage costs, and receive alerts before hitting rate limits. Windows port of Claude Usage Tracker (macOS).
- Real-time usage monitoring — Session (5-hour) and weekly usage percentages, Opus/Sonnet breakdowns
- Floating widget — Always-on-top compact widget with dock/undock, switchable from the popover
- 5 tray icon styles — Battery, Progress Bar, Percentage, Ring, Compact (Dot)
- Custom icon colors — Status-based (green/orange/red), monochrome, or pick any color
- Multi-profile support — Manage multiple Claude accounts with isolated credentials
- Notifications — Configurable alerts at 75%, 90%, 95% usage thresholds
- API billing tracking — Monitor console spend and prepaid credits
- Claude Code CLI sync — Automatically reads OAuth tokens from Windows Credential Manager
- Auto-start sessions — Detects 0% usage reset and starts a new session automatically
- Auto-update — Built-in update system with delta packages via Velopack
- Global hotkey — Toggle the dashboard with
Ctrl+Shift+C - Dark/Light theme — Follows system theme or manual override
- DPI-aware — Crisp icons at any display scaling (100%-200%)
- Download
Setup.exefrom the latest release - Run the installer — it will create a Start Menu shortcut and handle updates automatically
- Future updates are applied in-app via Settings > About > Check for Updates
- Download the
ClaudeTracker-*-portable-win-x64.zipfrom Releases - Extract to any folder
- Run
ClaudeTracker.exe
Note: The portable version does not support auto-updates.
Requirements:
- .NET 8 SDK or later
- Windows 10 (build 19041) or later
git clone https://github.com/TobiiNT/ClaudeTracker.git
cd ClaudeTracker
dotnet build
dotnet run --project src/ClaudeTracker- Launch Claude Tracker — it appears in the system tray
- Right-click the tray icon > Settings
- Go to the Connect tab
- Choose one of the authentication methods below
| Method | How to configure |
|---|---|
| Claude Code CLI (easiest) | If you use Claude Code, Claude Tracker automatically reads its OAuth token from Windows Credential Manager. No manual setup needed. |
| Claude.ai session | In the Connect tab, paste your session token and click Test Connection. Select your organization and save. |
| API Console | Enter your API console session token to track billing and prepaid credits. |
Settings are stored in %APPDATA%\ClaudeTracker\settings.json. Logs are written to %APPDATA%\ClaudeTracker\logs\.
| Setting | Default | Description |
|---|---|---|
| Refresh interval | 30s | How often usage is fetched (10-300s) |
| Icon style | Battery | Tray icon visualization style |
| Theme | System | Auto, Light, or Dark |
| Notifications | Enabled | Alert at 75%, 90%, 95% |
| Launch at login | Off | Start with Windows via Registry |
| Auto-start session | Off | Auto-start when usage resets to 0% |
- .NET 8 / C# / WPF
- MaterialDesignInXaml — Material Design UI
- Hardcodet.NotifyIcon.Wpf — System tray integration
- SkiaSharp — DPI-aware tray icon rendering
- CommunityToolkit.Mvvm — MVVM pattern
- Velopack — Installer and auto-update
- Microsoft.Extensions.DependencyInjection — DI container
src/ClaudeTracker/
├── Models/ Data models (usage, profiles, settings)
├── Services/ API client, credentials, notifications, updates
├── ViewModels/ MVVM view models
├── Views/ WPF windows and user controls
├── TrayIcon/ Tray icon management and SkiaSharp rendering
├── Utilities/ Constants, validators, formatters
├── Themes/ Shared WPF styles
└── Localization/ Resource strings
Contributions are welcome! See CONTRIBUTING.md for guidelines.
To report a vulnerability, please see SECURITY.md.
- Claude Usage Tracker by hamed-elfayome — the original macOS app this project is based on
- Built with help from Claude Code