dongxutang918-afk/agentwatch

★ 13PythonAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((repo))
    What It Does
      Claude Code alerts
      Push to Apple Watch
      Permission reminders
    Notification Types
      Approval required
      Task finished
      Attention event
    Delivery
      Bark push app
      iOS and Android
      Apple Watch sync
    Interface
      Python background script
      macOS menu bar app
      Windows tray app
    Themes
      Six persona styles
      CEO dramatic mode
      Imperial court style

mindmap root((repo)) What It Does Claude Code alerts Push to Apple Watch Permission reminders Notification Types Approval required Task finished Attention event Delivery Bark push app iOS and Android Apple Watch sync Interface Python background script macOS menu bar app Windows tray app Themes Six persona styles CEO dramatic mode Imperial court style

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Get an Apple Watch buzz when Claude Code pauses and needs you to approve a shell command.

USE CASE 2

Receive a phone notification the moment Claude Code finishes a long-running coding task so you can check the result.

USE CASE 3

Monitor AI agent activity from another room without sitting at your computer.

Tech stack

PythonSwiftC#Bark

Getting it running

Difficulty · easy Time to first run · 5min

Requires installing the Bark app on your phone and running a hook installer script to wire AgentWatch into Claude Code.

In plain English

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.

Copy-paste prompts

Prompt 1

I want to set up AgentWatch so my Apple Watch buzzes whenever Claude Code asks for permission. Walk me through installing the Bark app, getting my Bark key, and running the hook installer script.

Prompt 2

AgentWatch is installed but I'm only getting task-finished notifications, not permission-approval alerts. What hooks or config settings control which event types trigger a push?

Prompt 3

I want to change my AgentWatch notification theme to the CEO dramatic mode. Where in the config file do I set the persona, and what do the six available styles look like?

Open on GitHub → Explain another repo

← dongxutang918-afk on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.