Clusage

Claude usage tracking for your menu bar
Monitor your 5-hour and 7-day rate limit windows, see momentum and projections, and never get surprised by a rate limit again.

Install

Homebrew (recommended)

brew install seventwo-studio/tap/clusage

Manual Download

Download the latest release

1. Download Clusage.dmg from the latest release
2. Open the DMG and drag Clusage to your Applications folder
3. Launch Clusage — it lives in your menu bar
4. Follow the onboarding to import your Claude Code credentials from the keychain

Clusage requires macOS 26 (Tahoe) or later.

Features

• Real-time usage tracking — 5-hour and 7-day rate limit windows with auto-polling
• Menu bar icon — always-visible usage at a glance
• Momentum engine — velocity, acceleration, ETA to ceiling, burst detection
• 7-day projections — projected usage at reset, daily budget, pacing status
• Granular 7-day tracking — sub-integer interpolation between API ticks
• Smart polling — adapts frequency based on activity, detects Claude processes, respects rate limits
• Dashboard — detailed gauges, charts, and account info in a transparent window
• Widget — macOS widget for quick usage checks
• Multi-account — track multiple Claude accounts simultaneously
• ClaudeLine integration — exposes ~/.claude/clusage-api.json for ClaudeLine status line components

ClaudeLine Integration

Clusage integrates with ClaudeLine by writing usage data to ~/.claude/clusage-api.json. ClaudeLine picks this up automatically — no extra configuration needed.

Building from Source

Requires Tuist and Xcode with Swift 6.2 support.

git clone https://github.com/seventwo-studio/clusage.git
cd clusage
tuist generate --no-open
xcodebuild -scheme Clusage -configuration Release build

License

MIT