convez.ai
ComandoProdutividadeAvançado
kayomarz97

WristPilot

kayomarz97/wristpilot

Controle Claude Code do seu relógio com segurança E2E

Ver no GitHub
InicialPluginScore · de 0 a 100

Controle 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/wristpilot

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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)

  1. Watch: install WristPilot (Play Store) → tap Pair → a code like K7Q-4FN-2DJ appears.
  2. 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/)
    
  3. Fly:
    claude-watch run "fix the failing test in this repo"
    
    Permission prompts, questions, and completions now reach your wrist. Talk back with the watch's mic. claude-watch hooks install adds watch approvals to plain claude terminal sessions too.

No watch yet? The app's demo mode shows the whole flow without any setup.

Repo layout

PathWhat
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.

Ver o original no GitHub

Bom para

Relacionados