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
- Verify the connector name and password match exactly
- If you changed the password on the agent, re-pair from the app
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.