Referencia del CLI

Cada comando, cada flag y qué hace cada uno. La mayoría muestra una TUI interactiva cuando hay terminal y salida plana cuando no.

El comando hubbound

Ejecutar hubbound sin argumentos abre la TUI interactiva cuando hay una terminal. En una shell no interactiva imprime la ayuda y termina.

El CLI habla con el daemon local (hubboundd) por HTTP para analytics y credenciales de dispositivo, y con la nube de HubBound para distribuciones, auth y actualizaciones.

$ hubbound

# abre la TUI interactiva (solo con terminal)

Flags globales

--debug	Sube el nivel de log a debug. Flag persistente — funciona en todos los comandos. Los logs se escriben al directorio de logs de HubBound y se espejan a stderr.
--help, -h	Muestra ayuda de cualquier comando o subcomando.

Distribuciones

hubbound sync

Sincroniza tus distribuciones y materializa sus archivos localmente.

Uso

$ hubbound sync

Flags

--no-tui

Salida de texto plano sin el progreso interactivo de la TUI.

Notas

La fase 1 trae tus distribuciones a state/artifact_installs.json y state/kit_installs.json.
La fase 2 descarga los archivos de cada artefacto en state/artifacts y los conecta con tus herramientas.

hubbound install

Instala un kit o artefacto y sincronízalo localmente.

Uso

$ hubbound install <artifact|kit> <author/name[@version]>

Flags

--no-tui

Salida de texto plano sin el progreso interactivo de la TUI.

Ejemplos

$ hubbound install artifact jane-a1b2c3/my-hook

$ hubbound install kit jane-a1b2c3/ai-tools-bundle@1.2.0

Fija una versión exacta con @version.

hubbound uninstall

Desinstala un kit o artefacto de tu cuenta y de tus herramientas locales.

Uso

$ hubbound uninstall <artifact|kit> <author/name>

Flags

--local-only	Omite el borrado remoto de la distribución y solo limpia el estado local.
--no-tui	Salida de texto plano sin el progreso interactivo de la TUI.

Ejemplos

$ hubbound uninstall artifact jane-a1b2c3/my-hook

$ hubbound uninstall kit jane-a1b2c3/ai-tools-bundle --local-only

hubbound upgrade

Actualiza un kit/artefacto (o todo) a su última versión.

Uso

$ hubbound upgrade <kit|artifact> <author/name>

$ hubbound upgrade all

Flags

--no-tui

Salida de texto plano sin el progreso interactivo de la TUI.

Ejemplos

$ hubbound upgrade artifact jane-a1b2c3/my-hook

$ hubbound upgrade all

Actualiza todos los kits y artefactos instalados.

Cuenta y dispositivo

hubbound auth login

Autenticación via Device Code Flow.

Uso

$ hubbound auth login

Flags

--json	Salida JSON (también fuerza salida no interactiva).
--no-tui	Salida de texto plano sin la TUI.

Notas

Con una TTY muestra una pantalla de login interactiva; si no, imprime la URL de verificación y el código.
El código se copia al portapapeles automáticamente cuando es posible.
Tras la autorización, el dispositivo se enrola para analytics (credenciales DPoP).

hubbound auth status

Muestra el estado de autenticación.

Uso

$ hubbound auth status

Flags

--json

Salida JSON.

Ejemplos

$ hubbound auth status

✓ Logged in (device <id>, token expires <ts>)

hubbound auth logout

Borra las credenciales de autenticación.

Uso

$ hubbound auth logout

Notas

Revoca el dispositivo del lado del servidor. Si no se puede alcanzar el servidor, las credenciales locales se borran igual y se muestra una advertencia.

hubbound device status

Muestra el estado de las credenciales del dispositivo de analytics.

Uso

$ hubbound device status

Flags

--json

Salida JSON.

Notas

Consulta al daemon local — tiene que estar corriendo.
Reporta estado de enrolamiento, ID de dispositivo, expiración del token y ruta de credenciales.

Daemon

hubbound daemon status

Muestra el estado del servicio del daemon.

Uso

$ hubbound daemon status

hubbound daemon health

Verifica la salud del daemon por HTTP.

Uso

$ hubbound daemon health

Ejemplos

$ hubbound daemon health

Daemon is healthy at http://127.0.0.1:<port>

hubbound daemon install

Instala el daemon como servicio del SO (requiere privilegios de administrador).

Uso

$ sudo hubbound daemon install

Notas

Registra hubboundd como servicio del sistema (launchd / systemd / Windows Service).

hubbound daemon start

Inicia el servicio del daemon (requiere privilegios de administrador).

Uso

$ sudo hubbound daemon start

hubbound daemon stop

Detén el servicio del daemon (requiere privilegios de administrador).

Uso

$ sudo hubbound daemon stop

hubbound daemon restart

Reinicia el servicio del daemon (requiere privilegios de administrador).

Uso

$ sudo hubbound daemon restart

hubbound daemon uninstall

Desinstala el servicio del daemon (requiere privilegios de administrador).

Uso

$ sudo hubbound daemon uninstall

Analytics

hubbound analytics doctor

Diagnostica el backlog de sincronización de analytics (pasivo, solo lectura).

Uso

$ hubbound analytics doctor

Flags

--output <tui|json>

Formato de presentación. Por defecto "tui" — pantalla interactiva con pestañas Overall y por tabla.

Notas

Trae una snapshot de solo lectura del daemon local: watermarks, filas pendientes y cola de subida. No ejecuta check ni export.

hubbound analytics push

Fuerza un ciclo de check y export/subida de analytics.

Uso

$ hubbound analytics push

Flags

--force	Ignora el backoff de NextCheckAt en subidas pendientes.
--wait-timeout <duración>	Cuánto esperar la confirmación de la nube (0 desactiva la espera). Por defecto 2m.
--json	Imprime el resultado en JSON.
--no-tui	Salida de texto plano sin la TUI.

Ejemplos

$ hubbound analytics push --force

$ hubbound analytics push --wait-timeout 0 --json

Actualizaciones

hubbound update

Busca una actualización firmada y aplícala opcionalmente.

Uso

$ hubbound update

Flags

--force	Busca incluso cuando las actualizaciones automáticas están desactivadas.
--yes	Aplica una actualización preparada sin preguntar.
--helper <ruta>	Ruta del ejecutable hubbound-helper (por defecto usa HUBBOUND_HELPER o lo busca en PATH).
--no-tui	Salida de texto plano sin la TUI.

Notas

Busca, descarga y verifica la última actualización firmada. Cuando hay una preparada, pregunta si aplicarla ahora (helper elevado) o después.
Aplicar cambia el bundle completo de la suite — hubbound, hubboundd, agent y helper quedan en la misma versión.

hubbound update status

Imprime el estado de actualizaciones.

Uso

$ hubbound update status

Flags

--json	Imprime JSON.
--no-tui	Salida de texto plano sin colores.

Notas

Muestra canal, versiones actual/disponible/pendiente, último chequeo y último error.

hubbound update check

Busca, descarga y verifica la última actualización firmada.

Uso

$ hubbound update check

Flags

--force	Busca incluso cuando las actualizaciones automáticas están desactivadas.
--json	Imprime JSON.
--no-tui	Salida de texto plano sin la TUI.

hubbound update apply

Pídele a hubbound-helper que aplique la actualización firmada preparada.

Uso

$ hubbound update apply --force

Flags

--force	Confirmación de seguridad obligatoria — el comando se niega a correr sin ella.
--helper <ruta>	Ruta del ejecutable hubbound-helper.
--no-tui	Salida de texto plano sin la TUI.

Notas

Requiere una actualización preparada (ejecuta hubbound update check primero) y privilegios elevados — por diseño vuelve a pedir sudo / UAC.

Diagnóstico

hubbound doctor

Diagnostica las integraciones de herramientas de Hubbound.

Uso

$ hubbound doctor

$ hubbound doctor diagnose

Flags

--output <tui\|json>	Formato de presentación. Por defecto "tui".
--verbose	Muestra logs de diagnóstico en stderr.

Notas

doctor y doctor diagnose son equivalentes — solo lectura, no modifican archivos.

hubbound doctor repair

Repara los assets propios de Hubbound que falten.

Uso

$ hubbound doctor repair

Flags

--output <tui\|json>	Formato de presentación. Por defecto "tui".
--verbose	Muestra logs de diagnóstico en stderr.

Notas

Reescribe la configuración propia de Hubbound para los proveedores soportados (ej. Claude Code, git-ai).

hubbound version

Imprime la versión instalada.

Uso

$ hubbound version

Ejemplos

$ hubbound version

hubbound v1.0.0