5-minute setup

no account. no signup. just connect.

install the host, scan a qr code, and you're in. your phone connects directly to your machine. no cloud relay, no third-party servers.

warning

this grants paired devices full terminal access with your user privileges. only use over tailscale or a trusted local network. never expose to the public internet.

1) install tailscale

install tailscale on both your phone and your dev machine and sign in with the same account.

download tailscale →

2) install the host

pick your platform:

macos (homebrew) 
brew tap diab-ma/pseudocoder-host https://github.com/diab-ma/pseudocoder-host
brew install pseudocoder
linux 
curl -sSL https://raw.githubusercontent.com/diab-ma/pseudocoder-host/main/install.sh | bash
windows (wsl2)

run inside wsl:

curl -sSL https://raw.githubusercontent.com/diab-ma/pseudocoder-host/main/install.sh | bash

full instructions live in the host repo readme.

host installation docs →

3) start + pair

go to your project directory, start the host, and scan the qr code inside the mobile app. 

cd /path/to/your/project
pseudocoder start --pair --qr

if the qr code won’t scan, you can enter host ip + port + pairing code manually (see troubleshooting in the host repo).

what you should do first

  • start a coding session (claude code / opencode recommended)
  • watch terminal output live from your phone
  • review the first diff card and reject something on purpose
  • approve a command only when you’re comfortable
back to landing →