Free macOS Menu Bar App Shows Real-Time Claude Usage Stats via SQLite Cookie Decryption

Claude Usage Tracker is a free macOS menu bar app that shows real-time Claude usage stats — including session percentage, weekly limit, monthly spend, and routine runs — without requiring an API key or manual token setup.

How It Works

The app reads Claude desktop app's encrypted SQLite cookie database, decrypts the session key via macOS Keychain, then hits Claude's internal usage API. Everything stays local — no data is sent anywhere.

Features

• Live session % in menu bar with color changes (green → yellow → red) as you approach limits.
• Dropdown shows: session reset countdown, weekly %, monthly spend vs budget, routine runs (x/5), and design limit %.
• Local web dashboard at localhost:8080 with charts and CSV export.
• Auto-syncs every 2 minutes by reading Claude desktop app session.
• Notifications at 25%, 50%, 75% session usage.

Setup

Three commands:

git clone https://github.com/divaaker/claude-usage-tracker
cd claude-usage-tracker
pip3 install -r requirements.txt && cp override.example.json override.json && bash run.sh

Requirements

macOS only (uses Keychain + rumps menu bar framework). The source is open for forks and PRs — the author welcomes auto-launch on login or a notification center widget contributions.