SlavomirDurej/claude-usage-widget

What it solves

Claude Usage Widget provides a way for users to monitor their Claude.ai usage limits in real-time without having to manually check within the web interface. It solves the problem of unexpectedly hitting usage caps by providing a visible, always-on-top desktop notification system.

How it works

The application is a standalone desktop widget built with Electron that communicates with the official Claude.ai API. It captures the user's session after a browser-based login and tracks session and weekly usage limits, as well as credit balances and monthly spend caps.

Who it’s for

Users of Claude.ai who want to keep a close eye on their remaining message limits and spending across different models (such as Sonnet, Opus, and Fable) and accounts.

Highlights

• Real-time Tracking: Monitors session and weekly limits with auto-refresh every 5 minutes.
• Visual Alerts: Gradient progress bars and desktop notifications that trigger at configurable warning and danger thresholds.
• Usage History: A toggleable 7-day chart showing trends over time.
• Multi-Account Support: Ability to run isolated instances for separate accounts using the --profile flag.
• Cross-Platform: Available for Windows, macOS, and Linux.
• Secure Storage: Encrypted local storage for credentials with no third-party server communication.