Agent Cannot Connect
- Check your internet connection
- Verify the relay is reachable:
curl https://vibe-remote.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
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/ymzuiku/vibe-remote/issues.