This project enables users to control and monitor Claude Code sessions directly from their Apple Watch. It targets developers who utilize Claude Code and own an Apple Watch, offering the benefit of real-time terminal output viewing, permission approvals, and voice command execution directly from their wrist, thereby enhancing workflow efficiency and reducing reliance on constant screen monitoring.

How It Works

The system comprises three core components: a Node.js Bridge Server running on a Mac, a SwiftUI iPhone companion app, and a SwiftUI watchOS app. Claude Code events, such as tool usage and permission requests, are intercepted by the Bridge Server via HTTP hooks. The server then streams these events to connected clients using Server-Sent Events (SSE). The iPhone app relays information to the Apple Watch using WCSession. Permission prompts are handled bidirectionally: the bridge blocks until the user approves or denies a request via the watch or phone, after which the decision is returned to Claude Code. This architecture allows for seamless, interactive control of AI coding sessions from a wearable device.

Quick Start & Requirements

• Prerequisites: macOS (13.0+), Node.js (18+), Xcode (16+ with watchOS SDK), iPhone (17.0+), Apple Watch (10.0+), Claude Code CLI (2.1+). Devices must be on the same Wi-Fi network; disabling "Private Wi-Fi Address" on the watch is recommended for discovery.
• Setup:
  1. Install bridge dependencies: cd skill/bridge && npm install.
  2. Configure Claude Code hooks: ./skill/setup-hooks.sh.
  3. Start the bridge server: cd skill/bridge && node server.js.
  4. Generate Xcode project: cd ios/ClaudeWatch && xcodegen generate.
  5. Build and run iOS/watchOS apps from Xcode.
  6. Pair the iPhone using the displayed 6-digit code; the watch auto-discovers the bridge or can be configured with a manual IP address.

Highlighted Details

• Live terminal output from Claude Code sessions (e.g., Read, Edit, Bash) displayed on the Apple Watch.
• Interactive permission prompts with options like "Approve," "Deny," and "Approve All" directly on the watch.
• Voice command input via watchOS dictation for controlling Claude Code.
• Support for AskUserQuestion prompts, rendering dynamic options as scrollable lists on the watch.
• Leverages Claude Code's PostToolUse, PermissionRequest, and Stop hooks for integration.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap are provided in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The permissive MIT license generally supports commercial use and integration within closed-source projects without significant restrictions.

Limitations & Caveats

• Requires all components (Mac, iPhone, Watch) to be connected to the same Wi-Fi network.
• Reliable Bonjour discovery on the Apple Watch may necessitate disabling its "Private Wi-Fi Address" feature.
• The system relies on the bridge server running continuously on the Mac.
• Specific versions of macOS, Node.js, Xcode, iOS, watchOS, and Claude Code are mandated.