Approve Claude Code from your wrist.

Halfway down the hall for coffee, Claude Code pauses on a single git worktree or docker compose confirmation — idling for twenty minutes until you walk back. LinkShell puts the exact command on your Apple Watch and iPhone Lock Screen so you tap Allow in one second without turning off permission checks.

iOS 17+ Lock-Screen buttons · watchOS 10+ companion & standalone Wi-Fi/LTE · E2E XChaCha20-Poly1305

Claudemacbook-pro · billing
Apply migration to local test database and run vitest

Tap on Lock Screen or Apple Watch

pnpm db:migrate:test && pnpm test

Signed approval sent to Host… ✓ Migration clean · 114 tests passed. Denied from wrist. Agent halted safely.

Try tapping Allow — your computer receives an authenticated, E2E-sealed RPC answer.

iPhone Lock Screen Live Activity showing Claude Code progress and Deny / Allow buttons
Apple Watch displaying a pending Claude Code permission request with 44pt Deny and Allow buttons

Engineered for real security — not webhook hacks

Forwarding shell commands through unencrypted Slack/Telegram bots leaks proprietary repo context and exposes an unauthenticated trigger. LinkShell keeps every permission card end-to-end encrypted.

iPhone Lock Screen & Dynamic Island

APNs Push-to-Start + LiveActivityIntent

While a turn runs, Dynamic Island tracks active tools and progress. The moment Claude Code or Codex hits an approval gate:

  • Zero app launch needed: On iOS 17+, Deny and Allow run directly inside the Lock-Screen Live Activity via LiveActivityIntent.
  • Inspect before deciding: Unsure about a shell pipeline? Tap the card body to open the full file diff and session timeline right at that event sequence.
watchOS 10+ · Companion & Standalone

Works Even When Your iPhone Stays on Your Desk

watchOS suspends long-lived third-party WebSockets aggressively, so LinkShell uses a dual-path architecture:

  • Companion relay: When your iPhone is in your pocket, Watch talks through WatchConnectivity with near-zero battery impact.
  • Standalone HTTPS /v2/poll: On Wi-Fi or cellular away from your iPhone, the Watch exchanges ephemeral X25519 keys and seals answers with XChaCha20-Poly1305. Plus 44pt buttons and quick voice replies.

Wrist Approvals vs YOLO Mode & Chat Bots

You should not have to disable every guardrail just so an agent can finish a refactor while you make dinner.

Comparing remote permission approval methods for Claude Code and Codex
Dimension LinkShell Watch + Lock Screen --dangerously-skip-permissions Telegram / Discord Hook Bots Mobile SSH App
Time to approve away from desk ~1 second — glance at wrist or Lock Screen, tap Allow 0 seconds (approves destructive mistakes too) 5–15 seconds (unlock phone, open chat app, tap callback) 20–40 seconds (unlock, reconnect SSH, attach tmux, press key)
Blast-radius protection Full guardrails stay active — review exact command & cwd before execution None on host filesystem, git history, or local secrets Partial — custom hook scripts often miss MCP or sub-agent tools Full, if session stays attached
End-to-end encryption Yes (Ed25519 + X25519 + XChaCha20-Poly1305) on iPhone & Watch Local only Plaintext commands stored on third-party chat servers SSH transport (requires VPN or exposed port)
Steer or inspect diffs mid-turn Short reply from Watch; full file diffs, queue & 120fps screen on iPhone No remote visibility when away Text snippets only; cannot browse diffs or take over terminal Raw terminal scrollback only

Three commands on Mac, Windows/WSL2, or Linux

$ npm i -g linkshell-cli
$ linkshell setup
# Attach Claude Code or Codex to LinkShell Host
$ linkshell claude
$ linkshell codex

Self-Hosted Gateway

$0

MIT open-source relay in one Docker command

  • Full iPhone, Android, and Apple Watch support
  • Pair by QR code; host your own nickname4th/linkshell-gateway
Self-hosting guide

iTool Yearly Membership

$26.49/yr

¥99/yr Alipay · or $3.19/mo (¥9.9/mo) monthly

  • Hosted official gateway + APNs push wakeups out of the box
  • Zero server upkeep; sign in once across Mac, Windows, WSL2 & iOS
  • Unlocks all 7 iTool apps for one annual price
Get iTool Yearly ($26.49/yr) ↗

Frequently asked questions

Do I have to unlock my iPhone to approve a Claude Code or Codex tool call?

No. On iOS 17 or later, LinkShell's Live Activity on the iPhone Lock Screen renders interactive Deny and Allow buttons powered by LiveActivityIntent. One tap answers the host daemon immediately while your phone stays locked.

Does LinkShell on Apple Watch work when my iPhone is out of Bluetooth range?

Yes. When your Apple Watch (watchOS 10+) is near your iPhone, it relays over WatchConnectivity. When your iPhone stays on your desk and your Watch is on Wi-Fi or LTE, the Watch polls /v2/poll directly over HTTPS and decrypts payloads locally using X25519 + XChaCha20-Poly1305 — the gateway still never sees plaintext.

Why not just run claude --dangerously-skip-permissions instead?

Skipping all permission checks gives an agent unrestricted shell, git push, rm, and credential access the moment a prompt misunderstands a path or hits untrusted repo content. LinkShell lets safe read/edit steps run fast while surfacing destructive bash, network, or deploy actions on your wrist in under a second.

Can I send a follow-up instruction from my Apple Watch?

Yes. Beyond Allow, Allow for Session, and Deny (all sized to 44pt+ tap targets), the Watch app lets you dictate or scribble a short steering reply straight into the active session.

Which agents trigger Lock-Screen and Apple Watch approvals?

Claude Code, OpenAI Codex, Gemini CLI, Cursor CLI, GitHub Copilot CLI, OpenCode, Qwen Code, Kimi CLI, Goose, and ACP-compatible agents running under LinkShell Host on macOS, Windows, WSL2, or Linux.

Keep your guardrails on. Keep moving.

Install LinkShell on your iPhone (the Apple Watch app installs right alongside it) and attach your next linkshell claude or linkshell codex session.