Claude Usage Widget

Pitch

Description

Comments

About this project

Claude Usage Widget is a sleek desktop application for Windows that provides real-time tracking of your Claude.ai usage statistics. Featuring visual progress bars, countdown timers, and a secure environment, this widget integrates seamlessly into your workflow while keeping you informed of your usage metrics.

Claude Usage Widget is a small, standalone Windows desktop app built to solve a simple problem: seeing how much Claude.ai usage you have left, in real time. The widget runs entirely locally, with no telemetry and no data sent anywhere except Claude.ai.

Key Features

Real-time Usage Tracking: Keep tabs on both session limits and weekly usage.
Visual Progress Bars: Offers clean, gradient progress indicators for easy comprehension of usage stats.
Countdown Timers: Circular timers conveniently display the time remaining until resets occur.
Auto-refresh: Automatically refreshes every 5 minutes to ensure data relevance.
Modern UI: A visually appealing interface featuring a dark theme that is both user-friendly and draggable.
Secure Storage: Protects sensitive credentials using encrypted storage.
Always on Top: Ensures the widget remains visible across all open applications for easy access to information.
System Tray Integration: Minimizes to the system tray for unobtrusive access.

Installation and Usage

After downloading the latest release from the Releases, the installation process is straightforward. Upon launching the widget for the first time, users can log into their Claude.ai account to start viewing their usage statistics.

Example of Usage Controls:

Drag: Move the widget by clicking and dragging the title bar.
Refresh: Instantly update data by clicking the refresh icon.
Minimize: Hide the widget to the system tray with the minimize option.
Close: Minimizes to tray without exiting the application.

Understanding Usage Display

Current Session: The progress bar indicates usage from 0-100% with a countdown timer showing time until the end of the 5-hour session. Color coding alerts users to their usage levels: purple (normal), orange (high), and red (critical).
Weekly Limit: Similar tracking for weekly usage with timed resets every Wednesday at 7:00 AM.

Privacy and Security

The widget prioritizes user security, ensuring all session credentials are stored locally and securely, with no information sent to third-party servers. It communicates solely with the official Claude.ai API for usage data.

Roadmap

Planned future enhancements include support for macOS and Linux, customizable themes, alert notifications, and more, ensuring continual improvement based on user feedback.

Support and Contributions

For any issues, users are encouraged to check the Issues page for troubleshooting guidance or create a new issue detailing their challenges. Contributions are welcomed through pull requests to enhance the widget further.