shobhit99/claude-watch

Агент Вотч

Управляйте Claude Code с вашего Apple Watch.
Смотрите выход терминала, подтверждайте права и отправляйте голосовые команды — всё это с запястья.

https://github.com/user-attachments/assets/5f478c28-2086-4696-9d76-e43dda853201

---

Что он делает

• Живой вывод с терминала на Apple Watch — смотрите, что делает Клод в реальном времени
• Запросы разрешения — одобрить или отклонить действия Клода с вашего запястья (Редактировать файл? Запустить команду?)
• Динамические вопросы — ответы на запросы AskUserQuestion со всеми отображаемыми опциями
• Голосовые команды — диктует команды Клоду через диктовку watchOS
• iPhone companion — интерфейс сопряжения, статус соединения, предварительный просмотр терминала, одобрения разрешений
• Bridge server — Node.js сервер на вашем Mac, который соединяет Claude Code с часами через HTTP-крючки + SSE

Архитектура

Система состоит из трёх компонентов:

1. Bridge Server (Mac)

Node.js HTTP-сервер (skill/bridge/server.js), который:

• Получает события из Claude Code через HTTP-крючки (PostToolUse, PermissionRequest, Stop и др.)
• Потоковая передача событий подключённым клиентам через события, отправленные сервером (SSE)
• Обрабатывает сопряжение с 6-значным кодом + сессионным токеном

Agent Watch

Control Claude Code from your Apple Watch. See terminal output, approve permissions, and send voice commands — all from your wrist.

https://github.com/user-attachments/assets/5f478c28-2086-4696-9d76-e43dda853201

---

                    WCSession
 Apple Watch    iPhone    Mac
  (SwiftUI)     sendMessage       (Relay)   HTTP    Bridge Server
                transferUserInfo           SSE     (Node.js)
                                                      |
                                            HTTP Hooks | PTY stdin
                                                      v
                                              Claude Code Session

What It Does

• Live terminal output on your Apple Watch — see what Claude is doing in real-time
• Permission prompts — approve or deny Claude’s actions from your wrist (Edit file? Run command?)
• Dynamic questions — answer AskUserQuestion prompts with all options displayed
• Voice commands — dictate commands to Claude via watchOS dictation
• iPhone companion — pairing UI, connection status, terminal preview, permission approvals
• Bridge server — Node.js server on your Mac that connects Claude Code to the watch via HTTP hooks + SSE

Architecture

The system has three components:

1. Bridge Server (Mac)

A Node.js HTTP server (skill/bridge/server.js) that:

• Receives events from Claude Code via HTTP hooks (PostToolUse, PermissionRequest, Stop, etc.)
• Streams events to connected clients via Server-Sent Events (SSE)
• Handles pairing with a 6-digit code + session token
• Advertises itself on the local network via Bonjour/mDNS
• Blocks on PermissionRequest hooks — waits for watch/phone approval, then returns the decision to Claude Code

2. iPhone App

A SwiftUI iOS app that:

• Discovers the bridge via Bonjour (or localhost fallback)
• Pairs using the 6-digit code
• Shows connection status + terminal output
• Displays interactive permission prompts (Yes / Yes all / No)
• Relays events to the Apple Watch via WCSession

3. watchOS App

A SwiftUI watchOS app that:

• Connects directly to the bridge over Wi-Fi (Bonjour or manual IP entry)
• Shows live terminal output (Read, Edit, Bash, Grep operations)
• Displays permission prompts with all options as scrollable buttons
• Supports voice command input via watchOS dictation
• Haptic feedback for task completion, approvals, and errors

Quick Start

Prerequisites

• macOS with Node.js 18+
• Xcode 16+ with watchOS SDK
• Apple Watch on the same Wi-Fi as your Mac
• Claude Code CLI installed

Apple Watch Wi-Fi Setup

1. Make sure your Apple Watch is connected to the same Wi-Fi network as the Mac running your Claude Code session