CC Watcher - Live Claude Code token usage, right on your desktop
by•
Free, 100% local macOS overlay that tracks your Claude Code 5-hour token window in real time. Hook-driven, always on top, zero config, no telemetry. Apple Developer ID signed and notarized. Universal binary (Apple Silicon & Intel).
Replies
Best
Maker
📌
Hey Hunters! 👋
Maker here. You know that vibe coding flow state — Claude Code humming, ideas shipping, you barely look up for two hours?
Yeah. I kept getting yanked out of it by the 5-hour rate limit. Mid-refactor. Mid-thought. Every single time.
I needed a way to feel my usage without breaking flow. Not another dashboard to open. Not another tab. Just… a glance.
So I built cc-watcher — a tiny floating overlay that shows your Claude Code token usage as a live chart in the corner of your screen. Always there. Never in the way. You just know.
What it does:
• 📊 Live stacked bar chart by model (Haiku / Sonnet / Opus), 5h window
• ⏱️ Session % + reset countdown always visible
• 🪟 True floating overlay — follows you across Spaces and fullscreen,
never steals focus
• 🔌 One-click hook install into ~/.claude/settings.json (plays nice
with ccstatusline & other hooks — no overwrites)
• ⚡ ~300ms live refresh via FSEvent when the DB changes
Under the hood:
• 100% native Swift + SwiftUI Charts (no Electron, no Node, no web view)
• Offline-first — zero network calls, your usage data never leaves your Mac
• Local HTTP server on loopback-only, self-heals if port is taken
• Universal binary (Apple Silicon + Intel), signed + notarized, auto-updates via Sparkle
Requires macOS 14+.
Would love your feedback — especially from fellow vibe coders who've had their flow broken one too many times. What would you want the overlay to show next? I'm eyeing per-project breakdowns and a weekly trend view.
Built this for myself, sharing because maybe you need it too. 🚀
Replies