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 — the desktop app is open, or the CLI agent shows Cloud: running.
- The QR code / connection link may have expired — refresh it (reopen the Connect panel in the desktop app, or press r in the CLI TUI) and scan again.
- If you reconfigured the connector, re-pair by scanning the new QR code.
No AI Provider Found
Install at least one provider on the agent machine:
npm install -g @anthropic-ai/claude-code
Ensure the CLI is in your PATH — run claude --version to verify. In the desktop app, use Settings → Setup guide → Recheck to re-detect providers. Or pick the built-in Btelo Agent with your own DeepSeek / MiniMax key.
Port Conflict
The agent uses port 24385 by default. If occupied, it picks a random port automatically. To set a custom port for the CLI agent:
PORT=8080 vibe-remote
Force Update to Latest Version
Desktop app: open Settings → Check for updates, then Restart & update. If it's still stuck, download the latest build from the download page and reinstall over the existing app.
CLI agent: if it's stuck on an old version or auto-update didn't apply, re-run the install command to fetch the latest release:
Linux / macOS
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
In the desktop app, logs are available from the app window. For the CLI agent, logs appear in the TUI viewport (or stdout in headless mode). Log files are stored in ~/.vibe-remote/logs/.
Getting Help
File an issue at github.com/btelolabs/btelo-coding-release/issues.