ClaudeUsageBar

May 13, 2026 · View on GitHub

Track your Claude.ai usage right from your Mac menu bar!

License: MIT macOS

ClaudeUsageBar - #1 Product of the Day

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

Setup Guide

✨ 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

🔗 Other projects

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

Made with ❤️ for the Claude community