Cuándo usar el CLI
El agente CLI ejecuta Btelo Coding desde el terminal. Es la opción adecuada cuando:
- Estás en Linux — no hay aplicación de escritorio para Linux.
- Estás ejecutando en un servidor headless o VPS sin entorno de escritorio.
- Quieres programar o automatizar cómo arranca el agente.
En Mac y Windows, la aplicación de escritorio es la forma recomendada de ejecutar el agente — una descarga, una guía de configuración y sin terminal. Recurre al CLI allí solo si quieres específicamente un flujo de trabajo en terminal.
Instalación
Linux / macOS:
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell):
irm https://coding.btelo.com/install.ps1 | iex
Inicia el agente
vibe-remote
Aparece la TUI. Pulsa c para configurar el nombre y la contraseña del conector. El agente se conecta automáticamente al relay en la nube y muestra un código QR de emparejamiento en el Dashboard. Escanéalo desde la app de iOS para conectarte.
Atajos de la TUI (pestaña Dashboard):
| Tecla | Acción |
|---|---|
| c | Configuración — establecer nombre y contraseña del conector |
| w | Cambiar de servidor relay |
| d | Gestionar dispositivos conectados |
| r | Actualizar el código QR |
| h | Mostrar / ocultar el código QR |
| m | Alternar rol del QR (Admin / Miembro) |
| y | Copiar el enlace del QR al portapapeles |
| t | Ayuda de escritorio |
| i | QR de instalación (enlace a la App Store) |
| u | Reiniciar tras la actualización |
| s | Detener el servidor |
| q | Salir de la TUI |
| 1/2/3 | Cambiar de pestaña (Dashboard / Logs / Install) |
Pestaña Logs: g salta al principio, G salta al final, x limpia los logs.
Modal de dispositivos: k expulsa el dispositivo seleccionado, r actualiza la lista.
Modo headless
La TUI interactiva no está disponible en Windows y no la querrás en un servidor headless. Inicia sin TUI en su lugar:
vibe-remote --headless --connector myconnector --password mypassword
Actualización
vibe-remote update
Tras descargar la actualización, pulsa u en la TUI para reiniciar con la nueva versión sin perder la conexión.
Referencia de la CLI
vibe-remote Inicia la TUI (por defecto)
vibe-remote --headless Inicia sin TUI
vibe-remote client Conecta a un agente remoto (modo inverso)
vibe-remote relay Ejecuta como servidor relay
vibe-remote delete-connector Elimina el conector guardado
vibe-remote update Actualiza a la última versión
vibe-remote version Muestra la versión
vibe-remote help Muestra la ayuda