Claude Usage Monitor — Monitor your Claude.ai usage…

Pitch

Description

Comments

About this project

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.

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 WKWebView to load usage information from claude.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.