WristPilot
kayomarz97/wristpilot
Controle Claude Code do seu relógio com segurança E2E
Ver no GitHubControle remoto para Claude Code direto do seu relógio Wear OS. Aprove comandos, responda prompts e dite continuações sem sair do seu smartwatch — com criptografia E2E, sem contas e sem rastreamento.
Instalação
npx convez-ai kayomarz97/wristpilot1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Aprovar ou rejeitar comandos do Claude Code enquanto longe do computador
- Responder perguntas e prompts diretamente do relógio usando voz
- Pausar, retomar e monitorar sessões de código sem voltar à máquina
- Integrar aprovações de watch em fluxos de trabalho CLI existentes
Veredito

Solução criativa e bem arquitetada que estende Claude Code a wearables com segurança séria (X25519 + AES-256-GCM). Ideal para quem quer mobilidade completa em sessões de código, mas exige setup inicial e Wear OS.
README
A tradução para o português deste README ainda está na fila.
WristPilot — your Claude Code sessions, on your wrist ⌚
A Wear OS remote control for Claude Code: approve commands, answer questions, dictate follow-ups, pause and resume — without walking back to your computer. End-to-end encrypted; no accounts; no tracking.
Unofficial — not affiliated with, sponsored, or endorsed by Anthropic. Claude is a trademark of Anthropic, PBC.
┌─────────────┐ E2E-encrypted ┌──────────────┐ FCM push ┌────────────┐
│ claude-watch │ ───────────────► │ relay (your │ ────────────► │ WristPilot │
│ bridge (CLI) │ ◄─── long-poll ─ │ Firebase) │ ◄── HTTPS ─── │ (Wear OS) │
└──────┬───────┘ ciphertext └──────────────┘ └────────────┘
└─ Claude Code (Agent SDK + hooks) — your machine, your credentials
Quickstart (≤ 8 minutes)
- Watch: install WristPilot (Play Store) → tap Pair → a code like
K7Q-4FN-2DJappears. - Computer:
npx claude-watch-bridge pair K7Q-4FN-2DJ # confirm the 6-digit security code shown on both screens, then: claude-watch serve # keep running (tmux/systemd templates in docs/) - Fly:
Permission prompts, questions, and completions now reach your wrist. Talk back with the watch's mic.claude-watch run "fix the failing test in this repo"claude-watch hooks installadds watch approvals to plainclaudeterminal sessions too.
No watch yet? The app's demo mode shows the whole flow without any setup.
Repo layout
| Path | What |
|---|---|
wear-app/ | Wear OS app (Kotlin, Compose for Wear OS M3, minSdk 30) |
bridge/ | claude-watch-bridge npm CLI (Node ≥20, Claude Agent SDK) |
relay/ | Firebase Functions relay — deployable in 15 min (docs/firebase-setup.md), fully self-hostable |
shared/ | Cross-platform crypto test vectors (Node ↔ JVM bit-exact) |
docs/ | CLI reference, relay protocol, publishing checklist, compliance pack, privacy policy |
assets/ | Play listing assets (generated from real UI renders: scripts/gen-assets.py) |
dist/ | Signed release artifacts |
Security model (the short version)
- Pairing performs an X25519 exchange with a 6-digit SAS you verify on both screens.
- Every message is AES-256-GCM with the routing header authenticated (AAD), per-direction keys, monotonic sequence numbers, and a ±5-minute timestamp window — the relay can neither read nor undetectably replay/reorder anything.
- The relay stores ciphertext only, auto-deletes within 24h, and wipes instantly on unpair.
- The watch can only start sessions in directories you explicitly allowlisted
(
claude-watch projects add <path>); permission prompts default closed in headless mode. - Your Anthropic credentials never leave your computer. Full spec:
docs/relay-protocol.md.
Building
# bridge + relay
cd bridge && npm i && npm test && npm run build
cd relay/functions && npm i && npm test && npm run build
# watch app (JDK 17+, Android SDK 36)
cd wear-app && ./gradlew :app:testDebugUnitTest :app:assembleDebug
./gradlew :app:recordRoborazziDebug # regenerate listing screenshots from real UI
Release signing reads RELEASE_STORE_FILE/… from .env (see .env.example).
Publishing: the entire path to the Play Store is scripted in docs/publishing-checklist.md.
License
MIT for bridge/ and relay/ (see bridge/LICENSE, relay/LICENSE) — the parts you run
and self-host. The watch app (wear-app/) is source-available for transparency and security
review, all rights reserved; the Play Store binary is distributed under the store listing terms.