Prerequisites
- A computer running macOS, Linux, or Windows
- An AI coding tool — Claude Code (recommended), Codex, or OpenCode
- An iPhone running iOS 18+
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, then set a password when prompted. The agent connects to the cloud relay automatically.
TUI shortcuts:
| Key | Action |
|---|---|
| c | Set connector |
| p | Change password |
| r | Switch relay server |
| d | Manage connected devices |
| i | Show iOS install QR code |
| q | Quit |
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
- Enter your connector name and password
- Start chatting with the AI on your machine
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