Prerequisites
- A computer running macOS, Linux, or Windows
- An AI coding tool — Claude Code (recommended), Codex, Gemini CLI, or OpenCode
- An iPhone running iOS 26+
Install
macOS / Linux:
curl -fsSL https://vibe-remote.com/install.sh | sh
Windows (PowerShell):
irm https://vibe-remote.com/install.ps1 | iex
Start the Agent
vibe-remote
The TUI appears. Press c to set your connector name and password. The agent connects to the cloud relay automatically and displays a QR code on the Dashboard.
TUI shortcuts (Dashboard tab):
| Key | Action |
|---|---|
| c | Config — set connector name & password |
| w | Switch relay server |
| d | Manage connected devices |
| r | Refresh QR code |
| h | Show / hide QR code |
| m | Toggle QR role (Admin / Member) |
| y | Copy QR link to clipboard |
| t | Desktop Help |
| i | Install QR (App Store link) |
| s | Stop server |
| q | Quit TUI |
| 1/2/3 | Switch tabs (Dashboard / Logs / Install) |
Windows note: TUI is not available on Windows. Use headless mode instead:
vibe-remote --headless --connector myconnector --password mypassword
Connect from iPhone
- Download vibe-remote from the App Store
- The agent TUI displays a Connect QR code on the Dashboard tab
- In the iOS app, tap + (Add Connector) and scan the QR code
- Start chatting with the AI on your machine
Tip: If the QR code has expired or connection fails, press r in the TUI to refresh the QR code, then scan again.
Update
vibe-remote update
CLI Reference
vibe-remote Start TUI (default)
vibe-remote --headless Start without TUI
vibe-remote relay Run as relay server
vibe-remote update Update to latest version
vibe-remote version Show version
vibe-remote help Show help