Claude Watch for Apple Watch and Claude Code

# Claude Watch: Control Claude Code from Your Apple Watch in Real Time

Developer shobhit99 has introduced Claude Watch — an open-source app for controlling Claude Code sessions right from your Apple Watch. The system lets you monitor the terminal and send commands, including voice ones, without leaving your main workspace. It solves the problem of quickly responding to notifications from AI tools during development.

Architecture includes three components: a network bridge on Mac, iPhone app, and watchOS client. The Node.js bridge integrates with Claude Code CLI via webhooks, intercepting terminal events. The iPhone acts as a mediator for synchronization, while the watch displays output and accepts input.

System Components

Network Bridge

Built on Node.js, it connects to Claude Code and monitors sessions. When events arrive (terminal output, requests), the bridge forms notifications and routes them to the iPhone over the local network. Requires Node.js and Claude Code CLI installation.

iPhone App

Handles communication between the bridge and the watch. Receives data over Wi-Fi, caches session state, and forwards to watchOS. Supports background mode for continuous monitoring.

watchOS Client

Manages the UI on the watch: displays terminal logs in swipe mode, text input via keyboard or voice dictation. Supports haptic feedback for new event notifications.

Requirements and Installation

To deploy, you need:

• Mac with macOS 13 or later.
• iPhone on iOS 17+.
• Apple Watch with watchOS 10+.
• All devices on the same Wi-Fi network.

Launch process:

• Install Node.js and Claude Code CLI on Mac.
• Clone the GitHub repo, build apps via Xcode.
• Start the bridge: npm install && npm start.
• Connect iPhone app and watchOS client.

The repo includes scripts for automated builds and a troubleshooting section: port fixes, firewall permissions, bridge restarts on network failures.

Benefits for Developers

Claude Watch extends Claude Code's capabilities with mobility. Senior developers praise it for TDD sessions: checking tests or logs without switching to Mac. In multitasking environments (e.g., multiple terminals), the watch enables quick responses to critical AI events.

// Example webhook in the bridge (Node.js)
app.post('/webhook', (req, res) => {
  const { event, data } = req.body;
  if (event === 'terminal_output') {
    sendToWatch(data);
  }
  res.status(200).send('OK');
});

The bridge code uses Express for endpoints and WebSocket for real-time transmission to iPhone.

Key Points

• Architecture: Three-part system (bridge-iPhone-watch) ensures low latency on local network.
• Input: Voice commands and text on watch integrate with Claude Code without losing context.
• Open Source: Full build instructions and fixes in GitHub repo.
• Limitations: Requires single Wi-Fi, macOS 13+; not for remote access.
• Use Case: Ideal for monitoring AI sessions in development.

— Editorial Team