A lightweight macOS menu bar app that monitors your Claude API usage in real time. Session limits, weekly quotas, rate limits, and pace — without ever leaving your workflow.
* Check the FAQ for a smooth installation on macOS Sequoia+
ClaudeWatch lives in your menu bar — always visible, never in the way
Session & weekly stats
Rate limits & pace
Compact mode
Light mode
Tiny pixel creatures that live on your Mac and react to your Claude API usage in real time
A friendly Claude-inspired blob
A retro pixel robot
A tiny plant in a pot
A playful little ghost
8 moods that follow your API usage
Wizard Clodey, Arcade Bytie, Bonsai Sprout, Reaper Ghosty — and many more waiting to be unlocked.
Your pet comments on your pace. Adjust chattiness from Quiet to Chatty — or mute it if you're in the zone.
Optional reminders to take breaks, drink water, and stretch — because you forgot again.
Hit the rate limit? Your pet has you covered — a mini game unlocks right in the popover
Move your pet left and right to catch colorful Claude tokens falling from above. Each catch scores a point.
Red rate-limit blocks fall faster as time goes on. Three hits and it's game over — your high score is saved.
Tokens get faster, blockers get more frequent. How long can you survive the rate limit?
No API keys, no configuration files, no backend
Download the .dmg and drag to Applications — done.
Claude Watch reads your existing Claude Code OAuth token from macOS Keychain. No extra login.
Usage appears instantly in your menu bar. Session, weekly, model limits, pace — all automatic.
Built for developers who live in the terminal
Color-coded status icon always one glance away. Show session %, weekly %, combined, or pace (%/h) — your choice.
Session (5-hour) and weekly (7-day) limits with progress bars, plus model-specific caps for Sonnet and Opus.
Rolling usage history visualized as mini trend charts. Configurable from 6 hours to 7 days.
Real-time burn rate (%/hour) with projected hours until session or weekly limits hit.
Alerts at configurable thresholds (50%, 80%, 90%…), on limit hit with reset ETA, and when limits restore.
Zero telemetry, zero analytics. Your OAuth token is read directly from the macOS Keychain — never leaves your machine.
Everything you might want to know
No. Claude Watch is fully local. It reads your existing OAuth token from macOS Keychain and queries the Claude API directly. Zero telemetry, no analytics, no third-party services.
No. Claude Watch reuses the OAuth token that Claude Code already stored in your macOS Keychain. If you can run Claude Code, Claude Watch works automatically.
Pro, Max (5x), and Max (20x) plans are fully supported. The app detects your plan automatically and adjusts limits and thresholds accordingly.
Every 2 minutes by default. You can choose between 2, 3, 5, or 10 minute intervals in Settings.
Claude Watch monitors your overall account usage, so it reflects usage from Claude Code, the web app, and any other client sharing the same account.
Yes. Claude Watch is MIT-licensed and fully open source. You can audit, fork, and contribute on GitHub.
Claude Watch is not signed with an Apple Developer certificate, so macOS Sequoia (15+) will block it on first launch. One-time fix:
Or run in Terminal: xattr -cr "/Applications/Claude Watch.app"