Free & Open Source — v1.0.0

Know Your Limits Before They Know You

TokenCap lives in your macOS menu bar and shows your Claude Code token usage in real time. Session windows, weekly breakdowns, per-model stats. No surprises.

macOS 14+ (Sonoma) · Apple Silicon & Intel · Code-signed & notarized

TokenCap menu bar showing color-coded usage percentages

Menu bar states

TokenCap session view showing 30% usage with gaugeTokenCap weekly breakdown showing per-model usage

Everything You Need. Nothing You Don't.

A single-purpose tool that does one thing well: keeps you informed about your Claude Code usage.

Real-Time Monitoring

Live session and weekly usage data, refreshed every 60 seconds. Always know where you stand.

Color-Coded Status

Green, yellow, red — at a glance, from the menu bar. No need to open anything.

Per-Model Breakdown

See usage for Sonnet, Opus, and OAuth apps separately. Know which model is burning through your allocation.

Smart Notifications

Configurable threshold alerts at 50%, 75%, 80%, 90% — or whatever you set. Never get throttled without warning.

Homebrew Install

One command. That's it. Or download the DMG if you prefer. Code-signed and notarized by Apple.

Zero Telemetry

No analytics. No tracking. No cloud. Your usage data stays on your machine. Open source and auditable.

Three Steps. Sixty Seconds.

If you already use Claude Code, you're 90% of the way there.

1

Install Claude Code

If you haven't already, install and authenticate Claude Code. TokenCap reads your existing OAuth token.

2

Install TokenCap

One Homebrew command or a direct DMG download. Drag to Applications, done.

3

Glance at Your Menu Bar

That's it. TokenCap lives in your menu bar and shows your current utilization with a color-coded percentage.

Install in One Line

Homebrew is the fastest way. Or grab the DMG if you prefer.

Terminal
$brew install --cask helsky-labs/tap/tokencap
Download DMGv1.0.0 · macOS 14+ required

Requirements

  • macOS 14 (Sonoma) or later
  • Claude Code installed and authenticated
  • Active Claude Pro, Team, or Enterprise subscription

Open Source. MIT Licensed.

TokenCap is fully open source. Read the code, submit issues, contribute features. Built by developers, for developers.

MIT License
Zero dependencies
Native Swift
No telemetry