agentwatch

AgentWatch is a tool that sends notifications to your Apple Watch or Android phone when Claude Code, an AI programming assistant, needs your attention while you are away from your computer. The core problem it solves is that Claude Code sometimes pauses and waits for you to approve a command, and without some way to alert you, that pause can stretch for many minutes while you are getting coffee or in a meeting.

The tool hooks into Claude Code's built-in event system and listens for specific signals: a permission dialog appearing that requires your approval, a task finishing, or a general attention event. When one of those fires, AgentWatch sends a push notification to your phone via Bark, a free iOS and Android app, which then syncs the notification to a connected Apple Watch or Android band. It intentionally filters out most events so you only receive alerts that actually require you to do something.

AgentWatch runs as a small background Python script, but also ships as a native menu bar app for macOS and a system tray app for Windows, built with Swift and C# respectively. All three options produce the same notifications. The GUI apps add convenience features like a one-click hook installer and a test push button.

There are six notification persona themes, mostly playful Chinese cultural styles including a dramatic CEO mode, an imperial court style, and a palace intrigue style. You pick whichever voice you prefer for your alert messages.

Setup requires installing Bark on your phone, configuring the app with your Bark key, and running a script that wires the hooks into your Claude Code installation. The whole process takes a few minutes. The tool stores no analytics and makes no extra AI calls beyond the Bark push.