Windows System Tray Monitor for Claude Code Quota

A developer has built a Windows system tray application to monitor Claude Code usage quotas in real-time. The tool addresses the frustration of manually checking usage limits during coding sessions.

Core Features

The application provides several key monitoring capabilities:

• Tray icon with color coding: Green (0-50% usage) → Orange → Red → Dark red → Grey at 100%
• Right-click context menu: Shows session percentage (5h), weekly percentage (7d), and time to reset
• Automatic refresh: Updates every 5 minutes using the official Anthropic OAuth API
• Fallback mechanism: Uses cached data if rate-limited by the API
• Desktop notifications: Alerts at 85% and 90% usage thresholds

Dashboard Components

The browser-based dashboard includes four tabs with detailed analytics:

• Today: Hourly bar chart, token comparison vs yesterday, active sessions
• This Week: Daily bar chart, peak day identification, daily average
• This Month: Same structure for current month analysis
• All Time: Quota trend chart with 80%/95% thresholds, top sessions, full statistics

Technical Details

The application has specific technical requirements and implementation details:

• Data source: Token data comes from local ~/.claude/projects/*.jsonl files
• Privacy: Only quota percentage calls go to Anthropic API; all other data stays local
• Requirements: Windows 10/11, PowerShell 5.1 (pre-installed), Claude Code logged in
• No dependencies: No Node.js or additional installations required

Setup Process

Installation is straightforward:

• Download ZIP from GitHub: https://github.com/edi19863/claude-usage-tray
• Double-click start.vbs to launch
• Run setup-autostart.bat for automatic launch at login

The developer accepts support via Ko-fi: https://ko-fi.com/edi1986