Watch Control

watch-control

Approve [Codex](https://github.com/openai/codex) and [Claude Code](https://github.com/anthropics/claude-code) commands from your Apple Watch.

[](https://cryptopilot.dev/watchcontrol) [](LICENSE)


Your AI agent runs on a remote Linux server inside `tmux`. When it needs approval, the request reaches your Apple Watch instantly through the native app stack (bridge → iPhone app → watchOS app). If you configure Pushover, it can also notify as a fallback path. A single tap approves or denies, and your agent continues.

Supports Codex and Claude Code side-by-side, with two delivery paths:

• Native iPhone + Apple Watch app — bridge approvals relayed to iPhone/watch, with local notifications when the app is backgrounded
• Pushover notifications — optional fallback when native delivery isn't enough for your setup

---

How it works

┌────────────────────┐
│  Codex / Claude    │  running in tmux on your Linux server
└─────────┬──────────┘
          │ needs approval
          ▼
┌────────────────────┐     ┌─────────────────┐
│  codex_watch.sh    │────▶│ approve_webhook │  injects keystroke into tmux
│  (tmux poller)     │     │     .py         │
└─────────┬──────────┘     └─────────────────┘
          │
          │ POST /hooks/codex (or /hooks/permission for Claude Code)
          ▼
┌────────────────────┐     ┌─────────────────┐     ┌────────────────┐
│  bridge/server.js  │◀───▶│   iPhone app    │◀───▶│  Apple Watch   │
│  (Node.js + SSE)   │ SSE │  (relay + UI)   │ WC  │   native app   │
└────────────────────┘     └─────────────────┘     └────────────────┘
          │
          │ (optional fallback, no iPhone needed)
          ▼
┌────────────────────┐
│     Pushover       │  notification with action button
└────────────────