Monitor your Claude AI usage directly from the macOS menu bar.
This is a fork of Stats with added Claude AI usage monitoring.
# Uninstall original Stats if installed
brew uninstall --cask stats 2>/dev/null
brew tap solbish/tap
brew install --cask solbish/tap/stats
xattr -cr /Applications/Stats.appDownload Stats.dmg, open it, move to Applications, then run:
xattr -cr /Applications/Stats.appThe Claude module supports two authentication methods. Claude.ai Web is the primary method with more frequent updates.
This method uses browser cookies to fetch usage data directly from claude.ai.
Install the "Cookies Extractor" extension for Chrome/Edge:
- Chrome Web Store
- Or search "Cookies Extractor" in your browser's extension store
- Go to claude.ai and log in
- Click the Cookies Extractor extension icon in your browser toolbar
- Click "Copy as JSON Cookie"
- Open Stats settings (click the Stats icon in menu bar > Settings)
- Navigate to the Claude module
- Click "Import from Clipboard"
- You should see "Import Successful" confirmation
The status will change from "Not configured" to "OK" with the last fetch time.
If you use the Claude Code CLI, you can import tokens from your Keychain.
- Install Claude Code CLI:
npm install -g @anthropic-ai/claude-code - Log in:
claude login
- Open Stats settings > Claude module
- In the "Claude Code (fallback)" section, click "Import from Keychain"
- Grant Keychain access if prompted
Note: Claude Code method has a longer default interval because API rate limits are more strict.
Monitor your Claude AI usage directly from the macOS menu bar.
- 5-Hour Usage - Track your rolling 5-hour usage limit with real-time countdown
- 7-Day Usage - Monitor your weekly usage quota
- 24-Hour History Chart - Visualize usage patterns over time
- Peak Hours Indicator - Know when Claude is busiest (8 AM - 2 PM ET weekdays)
- Best Time Analysis - Find optimal times to use Claude based on historical data
- Multiple Widgets - Mini, Line Chart, Bar Chart, Pie Chart display options
The Claude module displays in your menu bar showing current 5-hour utilization.
Click the menu bar icon to see detailed usage information:
- 5-hour and 7-day usage bars with percentages
- Reset countdowns for each limit
- Model breakdown (Opus/Sonnet usage)
- 24-hour history chart
- Peak hours status
- Best time recommendations
The 24-hour history chart highlights peak hours (8 AM - 2 PM ET weekdays) as shaded areas. The status bar shows current off-peak/peak state with a countdown timer to the next change.
Configure authentication and update intervals.
The Claude module supports two authentication methods. Claude.ai Web is the primary method with more frequent updates.
This method uses browser cookies to fetch usage data directly from claude.ai.
Install the "Cookies Extractor" extension for Chrome/Edge:
- Chrome Web Store
- Or search "Cookies Extractor" in your browser's extension store
- Go to claude.ai and log in
- Click the Cookies Extractor extension icon in your browser toolbar
- Click "Copy as JSON Cookie"
- Open Stats settings (click the Stats icon in menu bar > Settings)
- Navigate to the Claude module
- Click "Import from Clipboard"
- You should see "Import Successful" confirmation
The status will change from "Not configured" to "OK" with the last fetch time.
Choose how often to refresh data:
- 10 seconds (for active monitoring)
- 30 seconds
- 1 minute (default)
- 2 minutes
- 5 minutes
If you use the Claude Code CLI, you can import tokens from your Keychain.
- Install Claude Code CLI:
npm install -g @anthropic-ai/claude-code - Log in:
claude login
- Open Stats settings > Claude module
- In the "Claude Code (fallback)" section, click "Import from Keychain"
- Grant Keychain access if prompted
- 1 minute
- 2 minutes
- 5 minutes (default)
- 10 minutes
Note: Claude Code method has a longer default interval because API rate limits are more strict.
| Indicator | Meaning |
|---|---|
| Green (0-50%) | Low usage, plenty of capacity |
| Yellow (50-80%) | Moderate usage |
| Orange (80-95%) | High usage, consider pacing |
| Red (95-100%) | Near limit, may experience throttling |
- 5-Hour Reset: Rolling window - resets portion used 5 hours ago
- 7-Day Reset: Weekly quota - resets portion used 7 days ago
Claude experiences higher load during:
- Peak: 8 AM - 2 PM ET, Monday-Friday
- Off-Peak: All other times
The indicator shows:
- Current status (PEAK/off-peak)
- Time until status changes
Based on your usage history, the module analyzes and recommends hours with lowest average usage.
Choose your preferred menu bar display:
| Widget | Description |
|---|---|
| Mini | Compact percentage display |
| Line Chart | Usage trend over time |
| Bar Chart | 5-hour and 7-day comparison |
| Pie Chart | Visual usage vs remaining |
Configure widgets in Stats settings > Claude > Widgets.
- Ensure you're logged into claude.ai in your browser
- Try re-exporting cookies with "Copy as JSON Cookie"
- Make sure clipboard contains the JSON before clicking Import
Your session token has expired. Re-export cookies from your browser.
Increase the update interval in settings to reduce API calls.
- Ensure Claude CLI is installed:
which claude - Ensure you're logged in:
claude status - Check Keychain Access has the claude credentials
- Check the "Last updated" time in the popup
- Verify internet connection
- Try clearing and re-importing credentials
- Credentials are stored in macOS Keychain (encrypted)
- No data is sent to third parties
- All communication is directly with claude.ai
- Session tokens are masked in the UI (only last 8 characters shown)
Report issues or request features at: https://github.com/solbish/stats/issues