When to Use the CLI
The CLI agent runs Btelo Coding from the terminal. It's the right choice when:
- You're on Linux — there is no desktop app for Linux.
- You're running on a headless server or VPS with no desktop environment.
- You want to script or automate how the agent starts.
On Mac and Windows, the desktop app is the recommended way to run the agent — one download, a guided setup, and no terminal. Reach for the CLI there only if you specifically want a terminal workflow.
Install
Linux / macOS:
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell):
irm https://coding.btelo.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 pairing QR code on the Dashboard. Scan it from the iOS app to connect.
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) |
| u | Restart after update |
| s | Stop server |
| q | Quit TUI |
| 1/2/3 | Switch tabs (Dashboard / Logs / Install) |
Logs tab: g jump to top, G jump to bottom, x clear logs.
Devices modal: k kick selected device, r refresh list.
Headless Mode
The interactive TUI is not available on Windows, and you won't want it on a headless server. Start without a TUI instead:
vibe-remote --headless --connector myconnector --password mypassword
Update
vibe-remote update
After the update downloads, press u in the TUI to restart on the new version without dropping your connection.
CLI Reference
vibe-remote Start TUI (default)
vibe-remote --headless Start without TUI
vibe-remote client Connect to a remote agent (reverse mode)
vibe-remote relay Run as relay server
vibe-remote delete-connector Delete the saved connector
vibe-remote update Update to latest version
vibe-remote version Show version
vibe-remote help Show help