Real-Time Desktop Overlay for Monitoring Claude Code Usage Limits

A new open-source tool allows developers to monitor Claude Code usage limits with a real-time desktop overlay. This widget, built to stay always-on-top, provides immediate visibility into your session and weekly usage without having to run the /usage command manually.

Key Details

• Session and Weekly Tracking: Displays current session usage within a 5-hour window, including reset times, and tracks weekly usage for all models as well as Sonnet-only usage.
• Alerts: The usage bars turn red and pulse when approaching limits, providing a clear visual alert to avoid hitting these limits during use.
• Customization: The widget is draggable, can be placed anywhere on the screen, and supports a cyberpunk light/dark mode toggle. It also features opacity controls via the system tray.
• Persistence and Refresh: Remembers its position between sessions and auto-refreshes every 5 minutes to provide up-to-date information.
• Technical Implementation: Utilizes Electron and node-pty to run the Claude Code’s /usage command within a pseudo-terminal, leveraging your existing authentication without needing an API key.
• Platform Support: Currently available for Windows 11, with opportunities for macOS and Linux contributions from the community.

Setup

Installation is straightforward: clone the repository, run npm install, and then npm start. Alternatively, Windows users can double-click the start.bat file. The tool is MIT licensed, ensuring it's free to use indefinitely.