All projects

ClaudeTokenUsage

A native macOS menu bar app that monitors your Claude AI token usage in real-time. See your current session (5h) and weekly (7d) limits at a glance, with configurable alerts before you hit the cap.

What it does

  • Real-time token usage display in the macOS menu bar
  • Popover dashboard with session (5h) and weekly (7d) limit tracking
  • Configurable notifications before hitting usage caps
  • Secure API key storage via macOS Keychain
  • Auto-refresh with customizable intervals
  • Lightweight, zero third-party dependencies

Tech stack

Built entirely in Swift 5.10 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 background polling. Requires macOS 14.0 Sonoma or later.