Watch Agent Assistant

Claude Code on your wrist.

Dictate a prompt on your Apple Watch, watch the reply stream in, and approve or deny tool requests without going back to your desk.

Set up your Mac

Two ways to chat

Cloud

Claude Code runs in a private sandbox on this server, signed in with your Claude account. Nothing to install. The server operator can see cloud chats.

Your Mac

Claude Code runs on your own Mac, in your own projects. Messages are end to end encrypted, so this server only relays data it can't read. Needs the plugin below.

Set up your Mac

The app can only reach your Mac once the Watchpilot plugin for Claude Code is installed there. The plugin connects your Claude Code session to your iPhone and Apple Watch. Install it once on each Mac you want to use.

You need:

  1. Install the plugin

    Open Terminal on your Mac and run:

    curl -fsSL https://watchagentassistant.alasolutions.co.uk/install.sh | bash

    It downloads the plugin to ~/.local/share/watchpilot, installs its dependencies and adds two commands to ~/.local/bin: claude-watchpilot and claude-watchpilot-pair.

  2. Pair your iPhone

    The installer shows an 8 character code. On your iPhone open Settings > Chat > Pair a machine and enter it.

    Your iPhone then shows a 6 digit code. Type it into Terminal, then confirm on the iPhone. Your Apple Watch is added to the same Mac automatically.

  3. Start Claude Code with the plugin

    In any project, run claude-watchpilot instead of claude. On first launch choose I am using this for local development. Channels are a Claude Code research preview, so the plugin loads as a development channel.

    Your Mac shows as online in the app while that session is running. Pick it as the target on your watch and start talking.

Prefer to read it first?

Download the installer (install.sh), read it, then run bash install.sh. It fetches the plugin bundle from this site. If you run your own hub, add --hub https://your-hub.example.

Commands

claude-watchpilotStart Claude Code with the plugin loaded
claude-watchpilot-pairPair another iPhone or Apple Watch, no session needed
/watchpilot:statusInside Claude Code: hub, paired devices and connection state
/watchpilot:pairInside Claude Code: pair a device from the session
/watchpilot:unpair <device>Inside Claude Code: remove a paired device

If something goes wrong

Missing bunInstall Bun with the command above, open a new Terminal window and run the installer again.
command not foundAdd ~/.local/bin to your PATH: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, then open a new Terminal window.
Code expiredPairing codes last 5 minutes. Run claude-watchpilot-pair for a new one.
Mac shows offlineThe app can only reach your Mac while claude-watchpilot is running.
Watch can't see your MacIn the iPhone app, swipe right on the Mac in Settings > Chat and tap Add Apple Watch while a session is running.

Privacy

Chats with your Mac are encrypted on your devices with keys this server never sees. Pairing uses a code you check on both screens, so the server can't insert itself. Plugin keys stay in your Mac's Keychain and device keys stay in the Secure Enclave.

Cloud chats run on this server, so they are visible to its operator.