ClaudeBeat

A native macOS menu bar app that monitors your Claude AI token usage in real-time. See your 5-hour session and 7-day weekly limits at a glance with circular gauges, get notified on session resets, and watch a gauge for every model the API reports — plus your Extra Usage credits.

What it does

• Real-time 5-hour session and 7-day weekly usage display in the menu bar
• Popover dashboard with circular gauges for detailed usage breakdown
• Weekly breakdown across all models, plus a gauge per model the API reports (e.g. Fable) and an Extra Usage credits bar
• Session reset notifications and customizable threshold alerts
• In-app Claude sign-in — the session lives in the macOS Keychain, never plaintext, with session-key paste as a fallback
• Configurable auto-refresh (15 seconds to 5 minutes)
• Install via Homebrew (brew install --cask taejunoh/tap/claudebeat) or just unzip and run — verified by Apple

Tech stack

Built entirely in Swift with SwiftUI for the dashboard UI and AppKit (NSStatusItem, NSPopover) for menu bar integration. Uses macOS Keychain for secure credential storage, UserNotifications for alerts, and Swift Concurrency (async/await) for thread-safe background polling. Requires macOS 14.0 Sonoma or later.