everything you need to get started.

getting started

new to pseudocoder? start here.

• 5-minute setup guide: install the host, pair your phone, and start supervising
• reliability notes: how the decision flow (validate, apply, verify) keeps you in control
• security overview: understand the zero-cloud architecture

host cli

the open-source cli that runs on your machine and streams to your phone.

• installation instructions: homebrew (macos), curl script (linux/wsl)
• full readme: commands, flags, and configuration
• report an issue: bugs, feature requests, or questions

common tasks

• pairing: run pseudocoder start --pair --qr in your project directory and scan the qr code in the app
• tailscale setup: install tailscale on both devices and sign in with the same account. no port forwarding needed
• tmux attach: start a tmux session on your machine, then attach to it from pseudocoder to pick up where you left off
• manual pairing: if qr won't scan, enter host ip + port + pairing code manually (see host troubleshooting)

recommended tools

pseudocoder works with any terminal-based ai coding tool. we recommend:

• claude code: best integration and optimized for smaller terminal windows
• opencode: similar experience, also terminal-native
• aider, cursor (terminal mode), copilot cli: all work well