Know your
Claude Code usage

A native menu bar app that keeps your usage visible, color-coded, and always one glance away.

Install with Homebrew View on GitHub

Everything at a glance

Built for developers who live in the terminal and want usage data without context-switching.

Live Usage Ring

The menu bar icon fills as your usage grows. Color shifts from green through orange to red, so you always know where you stand.

Usage History

Interactive graph with selectable time ranges — 1 hour to 30 days. Hover for precise values at any point in time.

Session Projection

Estimates whether you'll hit the rate limit before the session window resets. Plan your coding sessions accordingly.

Smart Notifications

Alerts for warning thresholds, critical levels, limit resets, and service incidents. Never get surprised by a rate limit.

Keychain Integration

Reads your existing Claude Code CLI credentials from macOS Keychain. No tokens to paste, no config files to edit.

Daily Stats

Messages sent, sessions started, tokens consumed — parsed from your local Claude Code history files. All stays on your machine.

Get started in seconds

One command. No dependencies, no sign-up, no config.

1

Install via Homebrew

$ brew install konradmichalik/tap/spark
2

Make sure Claude Code is authenticated

Spark reads the OAuth token stored by Claude Code CLI in macOS Keychain.

$ claude auth login
3

Launch Spark

Open from Applications or Spotlight. The usage ring appears in your menu bar — that's it.

To update: brew upgrade --cask konradmichalik/tap/spark · Requires macOS 14+ · Build from source