elliotykim

Claudewatch — Development skill for Claude Code

Development community

A macOS menu bar app that monitors your Claude Code usage and service status.

How to install Claudewatch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open elliotykim/claudewatch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claudewatch does

A macOS menu bar app that monitors your Claude Code usage and service status.

Alternatives in Development

Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★
Claude Status — macOS Menu Bar + Desktop Widget for Claude Code Session Monitoring 59 ★

README

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