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)

1. Go to claude.ai/settings/usage
2. Open Developer Tools (Cmd+Option+I) → Network tab
3. Refresh the page, click the "usage" request
4. 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

1. Download ClaudeUsageBar-Installer.dmg from Releases
2. Open DMG and drag ClaudeUsageBar to Applications folder
3. Launch ClaudeUsageBar from Applications
4. Set cookie from claude.ai (follow in-app instructions)
5. 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 code
• app/build.sh - Build script
• app/create_dmg.sh - DMG installer creation
• website/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

• Website: claudeusagebar.com
• Issues: GitHub Issues
• Releases: GitHub Releases

🔗 Other projects

• Mediaboost - Guaranteed PR feature: Mediaboost
• CheckWorth - AI net worth estimates from LinkedIn: CheckWorth

---

Made with ❤️ for the Claude community