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 — la app de escritorio está abierta, o el agente CLI muestra Cloud: running.
- El código QR / enlace de conexión puede haber caducado — actualízalo (reabre el panel Conectar en la app de escritorio, o pulsa r en la TUI del CLI) y escanéalo de nuevo.
- Si reconfiguraste el conector, vuelve a emparejar escaneando el nuevo código QR.
No se encuentra ningún proveedor de IA
Instala al menos un proveedor en la máquina del agente:
npm install -g @anthropic-ai/claude-code
Asegúrate de que la CLI está en tu PATH — ejecuta claude --version para verificar. En la app de escritorio, usa Ajustes → Guía de configuración → Volver a comprobar para volver a detectar proveedores. O elige el Btelo Agent integrado con tu propia clave de DeepSeek / MiniMax.
Conflicto de puerto
El agente usa el puerto 24385 por defecto. Si está ocupado, elige un puerto aleatorio automáticamente. Para establecer un puerto personalizado en el agente CLI:
PORT=8080 vibe-remote
Forzar actualización a la última versión
App de escritorio: abre Ajustes → Buscar actualizaciones, luego Reiniciar y actualizar. Si sigue atascada, descarga la última versión desde la página de descargas y reinstala sobre la app existente.
Agente CLI: si 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:
Linux / macOS
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
En la app de escritorio, los logs están disponibles desde la ventana de la app. Para el agente CLI, los logs aparecen en la vista de la TUI (o en stdout en modo headless). Los archivos de log se almacenan en ~/.vibe-remote/logs/.
Obtener ayuda
Abre una issue en github.com/btelolabs/btelo-coding-release/issues.