Your local coding agents, right in your pocket.
Leave Claude Code, Codex, Gemini CLI, or Copilot CLI working inside your real Mac, Windows, or WSL2 workspace. Review structured file diffs, steer mid-turn from your phone, tap Allow on your iPhone Lock Screen or Apple Watch, and preview localhost apps or stream a 120fps Mac screen — E2E encrypted.
Free forever with self-hosted MIT gateway · Pro $12/mo or $99/yr managed relay · XChaCha20-Poly1305 E2E
pnpm --filter @app/core test && pnpm build
Tap Allow to simulate approving a live bash prompt from your phone.
Start in three commands on Mac, Windows/WSL2, or Linux
Keep your existing repositories, environment variables, MCP tools, and agent credentials strictly local on your machine.
# 1. Install CLI & run first-time pairing (macOS, WSL2, or Linux)
$ npm i -g linkshell-cli
$ linkshell setup
# 2. Hand off any live session to your phone
$ linkshell claude
$ linkshell codex
LinkShell vs SSH + tmux (Termius), Tailscale + VNC & Cloud IDEs
Mobile SSH was built for server admin in 1995, not multi-turn AI diffs and tool approvals. VNC forces squinting across 4K desktop pixels.
| Capability | LinkShell | SSH + tmux / Termius | Tailscale + VNC / RDP | Cloud Web IDEs |
|---|---|---|---|---|
| Lock-Screen & Apple Watch Approve | 1-tap Live Activity & watchOS 10+ | None (unlock, attach tmux, type prompt) | None (zoom into desktop window) | None |
| Mobile Diffs & Mid-Turn Steering | Structured file diffs, sub-agents & follow-up queue | Wrapped ANSI wall of text | 4K desktop scaled down onto phone | Cramped browser tabs |
| 120fps Desktop + Localhost Previews | WebRTC + Metal 120fps Mac stream & port proxy | No desktop UI; manual SSH port flags | High-latency VNC / no structured timeline | Port preview only |
| End-to-End Encryption & Zero Open Ports | Ed25519 + X25519 + XChaCha20-Poly1305 (MIT gateway) | Needs exposed SSH or WireGuard mesh | VPN or third-party screen relay | Source runs on vendor cloud |
Self-host free forever, or let LinkShell Pro run the global relay
Self-Hosted Gateway (MIT)
Every LinkShell feature free with your own relay
- Run
nickname4th/linkshell-gatewayin one Docker command - Full iPhone, Apple Watch, Android & 120fps Mac remote desktop
- Pair by QR code; gateway forwards ciphertext only
LinkShell Pro
$12/mo monthly (save 31% yearly) · or $199/yr All-Access Pass (all 7 overseas iTool apps) · ¥9.9/mo / ¥49/yr via Alipay
- Managed zero-config E2E relay + global TURN fallback for screens
- Sign in once across Mac, Windows, WSL2, iPhone & Watch — no QR pairing
- Tax included · Expense-ready invoices · Cancel anytime
Frequently asked questions
How does LinkShell control Claude Code and Codex from an iPhone or Android?
LinkShell runs a lightweight host daemon on your Mac, Windows PC, WSL2, or Linux workstation (`linkshell host`). Your phone and desktop talk over outbound WebSockets sealed with X25519 + XChaCha20-Poly1305 end-to-end encryption — so you view live agent diffs, steer mid-turn, answer tool prompts, preview localhost ports, and stream your 120fps Mac screen from anywhere.
What makes LinkShell better than Termius or SSH + tmux on a phone?
Termius and mobile SSH wrap 140-column ANSI terminal dumps across a 6-inch screen, break when cellular IPs switch without Mosh/VPN plumbing, and give zero Lock-Screen or Apple Watch notifications. LinkShell renders each Claude Code / Codex turn natively with per-file diffs, queued follow-ups, interactive Live Activity approvals, and a 120fps WebRTC/Metal desktop view.
Can I switch seamlessly between my keyboard at my desk and my phone?
Yes. Run `linkshell claude` or `linkshell codex` inside your normal terminal. Walk away and approve or reply from your phone; sit back down and press any key in the terminal to resume right inside the same session.
Do my code diffs, secrets, or prompts ever touch the relay unencrypted?
No. Every host and device authenticates with Ed25519 keys and negotiates ephemeral X25519 session keys with XChaCha20-Poly1305 encryption. Neither the official gateway nor a self-hosted Docker relay can decrypt any session traffic, and coding agents stay strictly in your local shell.
Is LinkShell free, and what does LinkShell Pro include?
Every feature is 100% free forever when you run the open-source MIT gateway container (`nickname4th/linkshell-gateway`). LinkShell Pro ($12/month or $99/year USD tax-included; ¥9.9/mo or ¥49/yr CNY via Alipay) includes the managed global relay, TURN fallback for 120fps remote screens, and instant same-account multi-machine sync — or unlock all 7 overseas iTool apps including StupidMirror Pro ($149/yr) with the $199/yr All-Access Pass.
Ship faster without sitting chained to your chair.
Pair your Mac, Windows, or WSL2 workstation in under two minutes and carry Claude Code & Codex in your pocket — plus pair with StupidMirror for real-phone MCP testing.