Claudeusagebar

ClaudeUsageBar

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

[](https://opensource.org/licenses/MIT) [](https://www.apple.com/macos/)

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](https://github.com/Artzainnn/claudeusagebar/releases)** (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 →](app/README.md)

🚀 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

...