ClaudeUsageBar
Track your Claude.ai usage right from your Mac menu bar!
A lightweight, open-source macOS menu bar application that displays your Claude.ai session and weekly usage limits with real-time updates and notifications.
📥 Download
Download Latest Release (DMG Installer)
📦 Set Up (1mn)
- Go to claude.ai/settings/usage
- Open Developer Tools (
Cmd+Option+I) → Network tab
- Refresh the page, click the "usage" request
- Copy the full "Cookie" value from the Request Headers
✨ Features
- 🟢 Real-time usage tracking - Monitor session (5-hour) and weekly (7-day) limits
- 🎨 Color-coded menu bar icon - Visual spark icon that changes color (green/yellow/red)
- 🔔 Smart notifications - Alerts at 25%, 50%, 75%, 90% usage thresholds
- ⌨️ Keyboard shortcut - Toggle popup with Cmd+U from anywhere
- ⚡ Auto-refresh - Updates every 5 minutes automatically
- 🔒 Privacy-first - All data stored locally on your Mac
- 📊 Pro plan support - Shows weekly Sonnet usage for Pro subscribers
- 🎯 Menu bar only - No Dock icon, stays out of your way
See full feature list →
🚀 Quick Start
- Download
ClaudeUsageBar-Installer.dmg from Releases
- Open DMG and drag ClaudeUsageBar to Applications folder
- Launch ClaudeUsageBar from Applications
- Set cookie from claude.ai (follow in-app instructions)
- Done! Usage appears in menu bar
📸 Screenshots
Menu Bar Display:
⚡ 45% (Green spark icon when usage < 70%)
Popup Interface:
- Session (5-hour) usage with progress bar
- Weekly (7-day) usage with progress bar
- Weekly Sonnet usage (Pro plan only)
- Settings for notifications and shortcuts
📁 Repository Structure
app/ - macOS menu bar application (Swift/SwiftUI)
website/ - Landing page (HTML/CSS)
🛠️ Build from Source
Requirements:
- macOS 12.0 (Monterey) or later
- Xcode Command Line Tools
Build the app:
cd app
chmod +x build.sh
./build.sh
Create DMG installer:
./create_dmg.sh
The built app will be in app/build/ClaudeUsageBar.app
🔧 Development
Project Structure
app/ClaudeUsageBar.swift - Main application codeapp/build.sh - Build scriptapp/create_dmg.sh - DMG installer creationwebsite/index.html - Landing page
Key Technologies
- SwiftUI - Modern macOS UI framework
- AppKit - Menu bar integration
- Carbon - Global keyboard shortcuts
- NSUserNotification - System notifications (no permissions needed)
🤝 Contributing
Contributions are welcome! Here's how you can help:
- 🐛 Report bugs via Issues
- 💡 Suggest features or improvements
- 🔧 Submit pull requests
- 📖 Improve documentation
- 🌍 Translate the website
📄 License
MIT License - see LICENSE for details
⚠️ Disclaimer
This app uses Claude.ai's internal API endpoints which may change without notice. It is not affiliated with or endorsed by Anthropic. Use at your own risk.
🙏 Support
If you find this useful, consider:
- ⭐ Starring this repository
- 📢 Sharing with others who use Claude
🔗 Links
🔗 Other projects
- Mediaboost - Guaranteed PR feature: Mediaboost
- CheckWorth - AI net worth estimates from LinkedIn: CheckWorth
Made with ❤️ for the Claude community
