ccusage-menubar

Claude Code Usage MenuBar

日本語 | English

A lightning-fast native Swift macOS menubar application that displays Claude Code usage statistics in real-time.

💡 What is this?

This app monitors your Claude Code usage by reading local data files and displaying:
- Daily/Monthly costs - How much you've spent on Claude Code
- Token usage - Input/output tokens with cache statistics
- Real-time updates - Live monitoring in your macOS menu bar

Perfect for tracking your Claude Code usage and managing costs efficiently!

✨ Features

- 🚀 Ultra-fast performance: 0.57s loading (was 15+ seconds before optimization)
- ⚡ Smart caching: Two-level cache system with deduplication for instant updates
- 💰 Real-time monitoring: Tracks Claude Code usage from local data files
- 🎯 Minimal footprint: Native Swift app with tiny memory usage (~25MB)
- 🔄 Modern UI: Built with SwiftUI MenuBarExtra (macOS 13.0+)
- 💸 Accurate cost tracking: Shows daily and monthly costs with LiteLLM pricing
- 🔢 Cost calculation modes (v1.2.0): Three modes matching ccusage CLI
  - Auto (default): Uses pre-calculated costs when available, calculates from tokens otherwise
  - Calculate: Always calculates from current token pricing
  - Display: Only shows pre-calculated costs
- 🌍 Currency conversion: Real-time conversion to 33+ currencies with OS auto-detection
- 📊 Token display: Input/output token counts with smart formatting
- ⏰ Auto-refresh: Configurable refresh intervals (default: 60s)
- 📈 Advanced caching: Parallel processing using all CPU cores

📦 Installation

Download Pre-built Release (Recommended)

1. Download the latest release from GitHub Releases
2. Unzip Claude-Code-Usage-v*.zip
3. Move Claude Code Usage.app to your Applications folder
4. The app is now notarized by Apple - just double-click to…