Claude-Usage-Monitor
Monitor your Claude.ai usage effortlessly from the menu bar.
Pitch
Claude-Usage-Monitor is a native macOS menu bar app designed to keep track of Claude.ai usage in real time without the need for an API key. With features like a live usage counter, colour-coded indicators, and a popover dashboard, it provides essential insights at a glance while staying unobtrusive in your workflow.
Description
Claude Usage Monitor is a native macOS menu bar application designed to provide real-time tracking of your Claude.ai usage without the need for an API key. This streamlined tool integrates seamlessly into the macOS menu bar, offering a hassle-free user experience.
Key Features
- Menu-bar only: Operates without a Dock icon, minimizing distractions while providing essential usage insights.
- Live usage counter: Displays real-time metrics in the format
used/limit(e.g.,45/100) right within the menu bar. - Colour-coded status: The tree icon provides visual feedback on usage — transitioning from green to yellow, and finally red as limits approach.
- Popover Dashboard: Access a detailed overview featuring a circular progress ring, reset countdown, and additional statistics through a simple popover interface.
- Session-aware tracking: Employs a fetch interceptor to capture Claude's internal rate limits, ensuring that usage data reflects real-time session activity rather than just the overall billing period content.
- Auto-refresh: Automatically updates every 5 minutes, with manual refresh options available in the popover.
- Persistent login: Utilizes WebKit to keep your Claude session active automatically, requiring login only once.
Usage Insights
The application simplifies monitoring usage:
| Icon Color | Usage Status |
|---|---|
🌲 Green 45/100 | Ample messages left (less than 50% used) |
🌲 Yellow 67/100 | Approaching limit (50 – 80% used) |
🌲 Red 88/100 | Almost out (> 80% used) |
Additional Information
Clicking the menu bar icon reveals a popover with:
- Circular usage progress ring
- Reset countdown timer for the next usage window
- Total usage for the current billing period when available
- Rate limit indicator (Normal/Limited)
- Refresh button to force immediate data retrieval
- Quit button for easy exit from the app
Technical Details
- Data Source: The app utilizes a hidden
WKWebViewto load usage information fromclaude.ai/settings/usage, leveraging the stored browser session to capture real-time data through an injected JavaScript fetch/XHR interceptor. - Session Management: Automatically persists cookies, ensuring continuity between app launches. If the session expires, users will be prompted to log in again.
Compatibility
- Requires macOS 13 Ventura or later and an active Claude.ai account (available in Free, Pro, Team, or Max tiers).
- An internet connection is necessary for functionality.
0 comments
No comments yet.
Sign in to be the first to comment.