shobhit99/claude-watch

エージェント・ウォッチ

Apple WatchからClaudeコードを操作できます。 端末の出力を確認し、許可を承認し、音声コマンドを送信するのも手首からすべてです。

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

---

それが何をするのか

• Apple Watchのリアルタイム端末出力 — クロードがリアルタイムで何をしているか確認
• 許可プロンプト — 手首からクロードの行動を承認または拒否する(ファイルを編集?コマンドを実行する?)
• 動的質問 — すべての選択肢が表示されたAskUserQuestionのプロンプトに答える
• 音声コマンド — watchOSの口述によるクロードへの指示
• iPhone コンパニオン — ペアリングUI、接続状況、端末プレビュー、許可承認
• ブリッジサーバー — Mac上のサーバーで、HTT Node.js Pフック+SSEを介してClaude Codeをウォッチに接続するサーバー

建築

このシステムは3つの構成要素で構成されています。

1.ブリッジサーバー(Mac)

以下のようなNode.js HTTPサーバー(skill/bridge/server.js)を:

• HTTPフック(PostToolUse、PermissionRequest、Stopなど)を通じてClaudeコードからイベントを受け取ります。
• サーバー送信イベント(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