ClaudeUsageBar

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:

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

🛠️ Build from Source

Requirements:
- macOS 12.0 (Monterey) or later
- Xcode Command Line Tools

Build the app:

Create DMG installer:

The built app will be in app/build/ClaudeUsageBar.app

🔧…