Claudewatch

ClaudeWatch

Native macOS menu-bar app for tracking Claude Code usage and Anthropic service status.

• Subscription usage from ~/.claude/claudewatch-usage.json, written by the Claude Code statusline hook.
• Claude Code service health from https://status.claude.com/api/v2/components.json.
• Color-coded uptime history bar (30/60/90 days) sourced from incident data and the official status page.
• 26-week usage-history heatmap with session/streak/peak stats, approximated from local Claude Code usage observed while ClaudeWatch is running (Anthropic does not expose historical usage, so nothing before you started using ClaudeWatch is available), backed by a local event log retained indefinitely.
• Pay-as-you-go "extra usage" tracking: when enabled on your account, see monthly credits used vs. limit with a dedicated progress bar.
• Customizable progress bar colors with dynamic, status-matching, and preset options.
• Real-time relative timestamps with absolute tooltips on hover.
• macOS 14 Sonoma+, Swift 5+/SwiftUI, sandboxed, zero external dependencies.

Build

# One-time: point xcode-select at the full Xcode install if needed.
sudo xcode-select -s /Applications/Xcode.app
sudo xcodebuild -license accept
xcodebuild -runFirstLaunch

# Build the app:
xcodebuild -project ClaudeWatch.xcodeproj -scheme ClaudeWatch -configuration Debug build

# Run unit tests:
xcodebuild -project ClaudeWatch.xcodeproj -scheme ClaudeWatch test \
  -destination 'platform=macOS'

Or just open `ClaudeWatch.xcodeproj` in Xcode and Cmd-R.

Run

After building, the `.app` is under `~/Library/Developer/Xcode/DerivedData/...`. Launch it; a small percentage indicator appears in the menu bar. Click it (or press ⌘⌥C) to show the popover.

Usage data

ClaudeWatch reads usage from `~/.claude/claudewatch-usage.json`. This file is written by a Claude Code statusline hook — ClaudeWatch itself never calls the Ant