El agente no puede conectarse
- Comprueba tu conexión a Internet
- Verifica que el relay es accesible:
curl https://coding.btelo.com/ping - Comprueba si un firewall bloquea las conexiones WebSocket salientes (puerto 443)
La app de iOS no encuentra el agente
- Asegúrate de que el agente está en ejecución y muestra Cloud: running
- El código QR / enlace de conexión puede haber caducado — pulsa r en la TUI para refrescar el código QR y escanéalo de nuevo
- Si reconfiguraste el conector (pulsando c), debes volver a emparejar escaneando el nuevo código QR
No se encuentra ningún proveedor de IA
Instala al menos un proveedor:
npm install -g @anthropic-ai/claude-code
Asegúrate de que la CLI está en tu PATH — ejecuta claude --version para verificar.
Conflicto de puerto
El agente usa el puerto 24385 por defecto. Si está ocupado, elige un puerto aleatorio automáticamente. Establece un puerto personalizado:
PORT=8080 vibe-remote
Forzar actualización a la última versión
Si el agente está atascado en una versión antigua o la actualización automática no se aplicó, vuelve a ejecutar el comando de instalación para obtener la última versión:
macOS / Linux
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell)
irm https://coding.btelo.com/install.ps1 | iex
Cuando termine, reinicia el agente para cargar el nuevo binario.
Logs
Los logs aparecen en la vista de la TUI. En modo headless, los logs van a stdout. Los archivos de log se almacenan en ~/.vibe-remote/logs/.
Obtener ayuda
Abre una issue en github.com/btelolabs/btelo-coding-release/issues.