elliotykim

elliotykim / claudewatch

Public

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

11
3
100% credibility
Found Apr 15, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A native macOS menu bar app that monitors Claude Code subscription usage from a local file and Anthropic service status from a public page.

How It Works

1
🔍 Discover ClaudeWatch

You hear about this simple Mac tool that helps track your AI assistant usage limits and service health from the menu bar.

2
💻 Get the app ready

Follow the friendly guide to set up the app on your Mac so it runs smoothly in the background.

3
🔧 Connect your terminal

Run one easy setup command to link your terminal AI sessions, letting the app see your usage automatically.

4
🚀 See it in the menu bar

Launch the app and notice the tiny usage indicator or logo appear at the top of your screen.

5
📊 View your stats

Click the icon or press a shortcut to pop open a window with your current usage percentages and service status.

6
⚙️ Customize alerts

Tweak settings inside the app to get notifications for limit resets or service changes just how you like.

✅ Stay on top effortlessly

Now you always know your usage and service health at a glance, keeping your work flowing without interruptions.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claudewatch?

ClaudeWatch is a native Swift macOS menu bar app that displays your Claude Code subscription usage percentages (5-hour and weekly limits) and Anthropic service status at a glance. It reads local usage data from a JSON file updated by Claude Code's terminal statusline hook—no API keys or direct calls needed—and polls the public status page for outages. Click the icon or hit Cmd+Opt+C for a popover with details, progress bars, reset timers, and customizable settings like polling intervals and notifications.

Why is it gaining traction?

Unlike web dashboards or CLI checks, it lives in your macOS menu bar alongside other macos menu bar apps, with options for compact gauges, rings, or logo fills to dodge macos menu bar too many icons clutter. The included install script sets up the statusline hook instantly, adding live usage bars to your Claude Code terminal sessions. Developers grab claude watch github for its zero-deps, sandboxed SwiftUI polish and hotkey toggle, skipping bloated macos github desktop alternatives for focused monitoring.

Who should use this?

Terminal-heavy Claude Code users on macOS Sonoma+ who burn through rate limits during coding marathons and want menu bar alerts for resets or outages. It's ideal for AI-assisted devs juggling macos menu bar settings without alt-tabbing to consoles, especially if you're tweaking macos menu bar icons hidden behind notch or need a lightweight macos menu bar manager for tools like this over full macos github cli suites.

Verdict

Grab it from claude watch github if you're deep into Claude Code—solid docs, tests, and MIT license make setup painless despite 11 stars and 1.0% credibility score signaling early maturity. Not production-ready for teams yet, but a smart personal add for usage tracking without cloudwatch envy.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.