Your Android phone, one line away.
Pair once with a QR code, then drive the phone from your terminal, scripts or AI agents —
over Wi-Fi or mobile data, end-to-end encrypted.
Website · Docs · Download · Türkçe
![]() |
![]() |
![]() |
- adb from anywhere. Each paired phone shows up as
127.0.0.1:47100inadb devices, Android Studio and every adb-based tool — the phone can be on another network. pairspanCLI. Tap, type, swipe, find elements, screenshots, apps, logs:pairspan click "Log in".- MCP server for AI agents.
claude mcp add pairspan -- pairspan mcpgives Claude, Cursor or VS Code a phone to look at and act on.--read-onlylimits it to looking. - End-to-end encrypted. P-256 handshake and AES-256-GCM between your computer and phone; the gateway only routes ciphertext and never sees the pairing code.
- Self-hostable. The gateway and website are one 5.7 MB container with no state.
curl -fsSL https://pairspan.ferhatozcelik.com/install.sh | shInstalls Pairspan.app (menu bar) and links the bundled pairspan command. Then install pairspan-android-1.0.0.apk on the phone (or click Install app in the desktop app with the phone on USB), click Pair a phone, scan the code, and click Enable wireless ADB once over USB.
pairspan devices
pairspan launch com.android.settings
pairspan click "Network & internet"
pairspan screenshot shot.png
claude mcp add pairspan -- pairspan mcpFull guide: pairspan.ferhatozcelik.com/docs.
pairspan CLI ─┐
MCP (agents) ─┼─ local socket ─► Pairspan app (Tauri) ══╗ wss, end-to-end encrypted
scripts ─┘ (this user) keys · pairings · adb ║
▼
gateway (Rust, one container) — routes ciphertext
▲
Android app ═══════════╝ ── 127.0.0.1:5555 (adbd)
| Path | What |
|---|---|
crates/gateway |
Rust relay: authentication, pairing rooms, binary routing, /health, /metrics, serves the website |
crates/core |
Rust PC agent: identity, handshake, encrypted sessions, ADB tunnel, automation, local JSON-RPC |
crates/cli |
pairspan command and MCP server (talks only to the app) |
apps/desktop |
Tauri app (menu bar + window); bundles the CLI and adb |
apps/android |
Kotlin/Compose app; responder side of the protocol, bridge to the phone's adbd |
apps/web |
Next.js website and docs (static export) |
docs/ |
protocol.md, design.md, shared crypto test vectors |
cargo test -p pairspan-gateway -p pairspan-core -p pairspan-cli # includes an end-to-end pairing + tunnel test
(cd apps/android && ./gradlew :app:testDebugUnitTest :app:assembleDebug)
npm install && npm run build # website → apps/web/out
npm run desktop # Pairspan.app with CLI and adb inside
./install.sh --source # build and install from this checkout
docker build -t pairspan:latest . # gateway + website imageRun a local gateway: PORT=8080 cargo run -p pairspan-gateway, then set the gateway to ws://<your-ip>:8080/ws in the desktop and Android apps.
MIT. Vendored third-party code is listed in THIRD_PARTY_NOTICES.md.


