claude-watch: Claude Watch: The Haptic Safety Interlock for Autonomous Agents

Haptic Governance

As AI coding agents transition from passive copilots to autonomous actors, the primary friction point has shifted from capability to trust. Leaving an agent to refactor a codebase unattended requires a leap of faith. claude-watch addresses this by introducing a physical "Human-in-the-loop" (HITL) mechanism. It treats AI actions as high-stakes events requiring physical presence, turning a "Permission Request" in the CLI into a haptic vibration on the wrist.

You are no longer just a developer monitoring a terminal. You are a safety inspector holding a remote detonator. When the agent attempts a destructive action, the execution halts, and your wrist taps you for approval.

The Latency-First Stack

To make this low-latency "telemetry" possible, the architecture relies on a distributed bridge. A Node.js server acts as the central hub on the host machine, intercepting lifecycle events using Claude Code's HTTP Hooks system. This bridge holds the HTTP request from the CLI open until the user taps "Approve" on their Watch, creating a synchronous, blocking feel.

The relay mechanism utilizes Server-Sent Events (SSE) to push real-time terminal updates to the iOS ecosystem. Bonjour (mDNS) handles zero-config discovery on local Wi-Fi, eliminating the need for manual IP configuration. On the mobile side, a specialized OutputRingBuffer manages terminal output, ensuring the limited memory and screen space of the Apple Watch are not overwhelmed by large log bursts.

From Pilot to Overseer

This architecture fundamentally shifts the developer's location. By mapping watchOS dictation directly to the Claude Code standard input, claude-watch allows for "vibe coding" entirely away from the keyboard. The developer is untethered, able to initiate complex tasks and step away, relying on haptic alerts to know when their input is required.

Origin and Context

The motivation behind claude-watch stems from a desire for deeper visibility. As agentic tools mature, their internal workings are often abstracted away in favor of cleaner interfaces. This project was born out of a specific regression in visibility that pushed developers to seek alternative monitoring solutions.

The Agentic Monitoring Landscape

The ecosystem of "agentic monitoring" tools is rapidly expanding. While claude-watch focuses on ultra-mobile notification and control, other tools take different approaches to the same problem of agent visibility.

Where Watchtower acts as a Man-in-the-Middle proxy for deep data inspection, and Kanban Code serves as a heavy-duty orchestrator wrapping sessions into project boards, claude-watch carves out a niche as the dedicated remote control.