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

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
Anthropic API. Usage data is only updated while Claude Code is actively being
used in the terminal; ClaudeWatch has no way to fetch it independently.

Installing the statusline hook

The included statusline.sh script is a Claude Code
statusline
hook that serves two purposes:

1. Feeds ClaudeWatch — each time the…