Claude Code Usage Monitor Macos

Claude Code Usage Monitor for macOS

A native macOS menu bar application that monitors Claude Code token usage in real-time.

This is a Swift/macOS adaptation of Claude-Code-Usage-Monitor by Maciek-roboblog, adding a native GUI for macOS users.

Features

- Real-time token usage monitoring (updates every 6 seconds)
- Color-coded progress bars (green/yellow/red)
- Burn rate tracking with visual indicators
- Smart predictions for token depletion
- Automatic plan detection (Pro/Max5/Max20)
- Native macOS menu bar integration

Installation

Build Commands

How It Works

The app monitors Claude Code usage by reading JSONL files from:
- ~/.claude/projects/*.jsonl (default)
- Or paths in CLAUDE_DATA_PATHS environment variable

It tracks:
- Token usage in 5-hour session windows
- Burn rate from the last hour
- Time until token depletion
- Session reset times

UI Overview

Menu Bar: Shows usage percentage and burn rate emoji

Popover: Displays detailed information including:
- Token usage progress bar
- Current burn rate with emoji indicator
- Predictions and warnings
- Session timing information

Burn Rate Indicators

- 🐌  2000 tokens/min

Requirements

- macOS 13.0+
- Swift 5.9+
- Active Claude Code usage

Credits

This project is inspired by and based on Claude-Code-Usage-Monitor by Maciek-roboblog. The original Python implementation provided the foundation for token tracking logic and usage calculations.

License

MIT License