Claude Code Usage

A macOS menu bar app that displays your Claude Code CLI usage statistics.

Features

• Shows session (5h) and weekly (7d) usage with color-coded indicators
• Dual icon display: 🟢🟡 45/62% (session/weekly)
• Auto-refreshes every 5 minutes
• Manual refresh available
• Shows reset times for rate limits

Status Icons

• 🟢 Green = Usage below 50%
• 🟡 Yellow = Usage between 50-80%
• 🔴 Red = Usage at 80% or higher

Requirements

• macOS 10.15+
• uv package manager

Installation

1. Install uv if you haven't already:

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Build the app:

   python3 build_app.py

3. Open the app:

   open "Usage Inspector.app"

Setup

On first launch, click the menu bar icon and select "Set OAuth Token..." to enter your Claude Code OAuth token (generated by claude setup-token).

Running from Source

You can also run directly without building:

./usage_inspector.py

The script will automatically create a virtual environment and install dependencies on first run.