Throttle

Throttle is a macOS menu bar app and WidgetKit widget for tracking Claude Max and Codex Pro usage limits. It keeps session, five-hour, weekly, model-specific, and credit windows visible without opening either service in a browser.

Download

Current release: Throttle v1.0.0, published May 18, 2026.

1. Download the latest release from GitHub.
2. Open Throttle on macOS.
3. Sign in to the providers you want to track.
4. Keep Throttle in the menu bar or add the WidgetKit widget.

Features

• Claude Max and Codex Pro usage rings in a compact menu bar popover.
• WidgetKit widget backed by the shared App Group store.
• Session, five-hour, weekly, credit, and model-specific quota rows.
• Refresh age and reset-window labels.
• Keychain-backed token storage.
• Local notifications for usage thresholds.

Privacy

Throttle stores provider tokens in the macOS Keychain and shares usage summaries with its widget through the local App Group container. It does not run a separate backend or send usage data to a third-party service.

Development

Requirements:

• Xcode 16.4+
• macOS 14.0+
• XcodeGen
• rsvg-convert from librsvg, or ImageMagick, to regenerate the README image

Commands:

xcodegen generate
xcodebuild -project Throttle.xcodeproj -scheme Throttle -destination 'platform=macOS' build
cd ThrottleShared && swift test
node --test test/*.test.mjs
node scripts/render-dashboard-image.mjs

Architecture:

• Throttle: menu bar app and polling loop.
• ThrottleWidget: WidgetKit extension.
• ThrottleShared: models, API clients, Keychain storage, App Group storage, and utilities.