Agent Cannot Connect
- Check your internet connection
- Verify the relay is reachable:
curl https://coding.btelo.com/ping - Check if a firewall blocks outbound WebSocket connections (port 443)
iOS App Cannot Find the Agent
- Make sure the agent is running and shows Cloud: running
- The QR code / connection link may have expired — press r in the TUI to refresh the QR code and scan again
- If you reconfigured the connector (press c), you need to re-pair by scanning the new QR code
No AI Provider Found
Install at least one provider:
npm install -g @anthropic-ai/claude-code
Ensure the CLI is in your PATH — run claude --version to verify.
Port Conflict
The agent uses port 24385 by default. If occupied, it picks a random port automatically. Set a custom port:
PORT=8080 vibe-remote
Force Update to Latest Version
If the agent is stuck on an old version or the auto-update did not apply, re-run the install command to fetch the latest release:
macOS / Linux
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell)
irm https://coding.btelo.com/install.ps1 | iex
After it completes, restart the agent to pick up the new binary.
Logs
Logs appear in the TUI viewport. In headless mode, logs go to stdout. Log files are stored in ~/.vibe-remote/logs/.
Getting Help
File an issue at github.com/btelolabs/btelo-coding-release/issues.