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 track usage across all models or Sonnet-only.

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
• Separate tracking for all models and Sonnet-only usage
• Session reset notifications and customizable threshold alerts
• Secure API key storage via macOS Keychain
• Configurable auto-refresh (15 seconds to 5 minutes)
• Supports both session cookie and Claude Code OAuth authentication
• Lightweight, zero third-party dependencies

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.