CEO OS

claude-usage-tracker

Claude Usage Tracker

Native macOS menu bar app that monitors Claude AI usage in real time — 5-hour session window, weekly limits, Opus-specific consumption, API cost tracking, and Claude Code statusline integration.

Install

Homebrew cask from a third-party tap:

brew tap hamed-elfayome/claude-usage
brew trust --cask hamed-elfayome/claude-usage/claude-usage-tracker
brew install --cask claude-usage-tracker

Gotcha: Modern Homebrew refuses to load casks from untrusted third-party taps. The brew trust step is required between tapping and installing — otherwise install fails with "Refusing to load cask ... from untrusted tap."

App lands at /Applications/Claude Usage.app. Launch with open -a "Claude Usage"; it lives in the menu bar (no Dock icon).

Auth / setup

Needs a session key from claude.ai. On first launch it walks you through setup. Three auth options:

  • Claude Code CLI installed + logged in (easiest — already true on this machine)
  • Browser sign-in via the app (v3.0.2+)
  • Manual session-key extraction from claude.ai

Notes

  • Requires macOS 14.0+. This machine is on macOS 27 (Homebrew Tier 2 / pre-release warning, installed fine).

Private. Behind Cloudflare Access. © Karthik Kamalakannan.