Skip to content

v1.1 — menu bar, widget, and usage window

Choose a tag to compare

View all tags
@jpuritz jpuritz released this 21 Jul 20:00
v1.1
2e9b528

Native macOS app showing your Claude usage limits in the menu bar, a WidgetKit desktop widget, and a resizable usage window.

What's in this download

ClaudeUsage-menubar.zip contains the menu bar + usage window build. Unzip and drag Claude Usage.app to /Applications.

It is ad-hoc signed, so macOS quarantines it on first open. Clear that once:

xattr -dr com.apple.quarantine "/Applications/Claude Usage.app"

On first launch, click Always Allow when macOS asks for access to Claude Code-credentials — that token is what the app reads to fetch your usage.

The desktop widget is not in this download

Shipping the WidgetKit widget needs an App Group entitlement, which needs a provisioning profile from a paid Apple Developer account. A free Personal Team certificate is development-only and will not launch on another machine. So the widget requires building from source — free, but needs Xcode and a (free) Apple ID:

brew install xcodegen
./build-widget.sh

See the README for the one-time Team selection step.

Requirements

  • macOS 14 or later
  • An active Claude subscription and the Claude Code CLI, signed in

Features

  • Menu bar ring showing your 5-hour session limit
  • WidgetKit widget in small / medium / large (from source)
  • Usage window — resizable, remembers its frame, optional float on top
  • Notifications: 80%/95% thresholds, reset alerts, burn-rate pace warnings
  • Keeps sign-in alive automatically, without manual /login
  • Launch at login

Note

Unofficial and not affiliated with Anthropic. It calls an undocumented internal endpoint that may change without notice. Your token is sent only to api.anthropic.com; there is no telemetry.

Assets 3
Loading