v1.2.2

Bug fix: The app was preventing macOS from sleeping (closing laptop lid caused forced restarts and window restoration).

• Changed activity assertion from .userInitiated to .userInitiatedAllowingIdleSystemSleep — timers still run but the system can sleep normally
• Disabled window state restoration on the panel

v1.2.0 — Launch at Login

What's New

• Launch at Login: Right-click the widget to toggle auto-start on login via SMAppService
• Context menu: Right-click menu with "Launch at Login" (checkmark toggle) and "Quit"
• No new entitlements or helper apps required — works with ad-hoc signing

v1.1.0

What's New

Bug Fixes

• Fixed usage bars not appearing — The keychain credential format changed from hex-encoded to raw JSON, but the token parser tried hex decoding first. When hex decoding consumed the raw JSON as garbage, the fallback path was never reached. Token extraction now tries raw JSON first and supports the nested claudeAiOauth.accessToken key path.
• Fixed make install not updating the app — cp -R silently failed to overwrite quarantined .app bundles in /Applications. The install target now removes the old bundle before copying.

v1.0.0

Claude Code Usage Widget v1.0.0

macOS desktop widget showing your Claude Code usage as a contribution grid with real-time rate limit bars.

Install

Download: Grab UsageWidget.zip below, unzip, and move to /Applications.

Or build from source:

git clone https://github.com/emm3ttarmstrong/usage-widget.git
cd usage-widget
make install

What's included

• 16-week Mon-Fri contribution grid from local Claude Code logs
• 5-hour and 7-day rate limit bars from the Anthropic API
• Live refresh (30s local, 60s API)
• Hover tooltips, plan tier detection, position persistence
• Menu bar icon with refresh/quit

Requirements

• macOS 15.0+ (Sequoia)
• Claude Code installed (~/.claude/ directory)