Instala una vez.Todo sincronizado.
La CLI de HubBound instala los Kits y Artifacts de tu organización en cada herramienta de IA de una máquina con un solo comando, y el Runtime de HubBound mantiene esa máquina sincronizada en segundo plano.
¿Cómo instalo HubBound en mi máquina?
HubBound se instala con una descarga por sistema operativo: el paquete completo (CLI y Runtime), solo la CLI o solo el Runtime, para Windows, macOS y Linux. Cada enlace apunta a la última release de GitHub, así que el archivo que descargas siempre es la versión actual.
Elige qué instalar
El paquete completo es la instalación recomendada para la máquina de un desarrollador.
Elige tu sistema operativo
La descarga y el comando cambian juntos.
Paquete completo · Windows
Windows 10/11 · AMD64 · EXE · HubBound-Setup-amd64.exe
O instálalo desde una terminal
PS> Invoke-WebRequest https://github.com/hubbound/hubbound/releases/latest/download/HubBound-Setup-amd64.exe -OutFile HubBound-Setup-amd64.exe; Start-Process .\HubBound-Setup-amd64.exeEl instalador de Windows aún no tiene firma Authenticode, así que SmartScreen puede mostrar una advertencia antes de ejecutarlo. Compara su SHA-256 con la lista publicada antes de aprobarlo.
Paquete completo · macOS
Apple Silicon · ARM64 · DMG · HubBound-arm64.dmg
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/HubBound-arm64.dmg -o HubBound-arm64.dmg && open HubBound-arm64.dmgPaquete completo · Linux
Archivo · AMD64 · TAR.GZ · hubbound_linux_amd64.tar.gz
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/hubbound_linux_amd64.tar.gz -o hubbound_linux_amd64.tar.gz && tar -xzf hubbound_linux_amd64.tar.gzLos archivos comprimidos solo traen los binarios. Para un paquete nativo en Linux, elige la CLI o el Runtime: cada uno incluye DEB y RPM.
Solo la CLI · Windows
Windows 10/11 · AMD64 · MSI · HubBound-CLI-amd64.msi
O instálalo desde una terminal
PS> Invoke-WebRequest https://github.com/hubbound/hubbound/releases/latest/download/HubBound-CLI-amd64.msi -OutFile HubBound-CLI-amd64.msi; msiexec.exe /i .\HubBound-CLI-amd64.msi /qnSolo la CLI · macOS
Apple Silicon · ARM64 · PKG · HubBound-CLI-arm64.pkg
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/HubBound-CLI-arm64.pkg -o HubBound-CLI-arm64.pkg && sudo installer -pkg ./HubBound-CLI-arm64.pkg -target /Solo la CLI · Linux
Debian / Ubuntu · AMD64 · DEB · hubbound-cli_amd64.deb
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/hubbound-cli_amd64.deb -o hubbound-cli_amd64.deb && sudo apt install ./hubbound-cli_amd64.debSolo el Runtime · Windows
Windows 10/11 · AMD64 · MSI · HubBound-Runtime-amd64.msi
O instálalo desde una terminal
PS> Invoke-WebRequest https://github.com/hubbound/hubbound/releases/latest/download/HubBound-Runtime-amd64.msi -OutFile HubBound-Runtime-amd64.msi; msiexec.exe /i .\HubBound-Runtime-amd64.msi /qn /norestartSolo el Runtime · macOS
Apple Silicon · ARM64 · PKG · HubBound-Runtime-arm64.pkg
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/HubBound-Runtime-arm64.pkg -o HubBound-Runtime-arm64.pkg && sudo installer -pkg ./HubBound-Runtime-arm64.pkg -target /Solo el Runtime · Linux
Debian / Ubuntu · AMD64 · DEB · hubbound-runtime_amd64.deb
O instálalo desde una terminal
$ curl -fL https://github.com/hubbound/hubbound/releases/latest/download/hubbound-runtime_amd64.deb -o hubbound-runtime_amd64.deb && sudo apt install ./hubbound-runtime_amd64.debComprueba que funciona
- La CLI responde con su versión
- El Runtime está en marcha (se comprueba con la CLI)
- Inicia sesión en tu organización
Directo desde la release
- Última release en GitHub
- Todos los checksums SHA-256
- Autocompletado de shell:BashZshFishPowerShell
¿Qué diferencia hay entre la CLI y el Runtime de HubBound?
La CLI de HubBound es el comando que ejecutas para iniciar sesión, instalar, sincronizar y gestionar Kits y Artifacts; el Runtime de HubBound es el servicio en segundo plano que sigue trabajando sin ti, instala las distribuciones obligatorias y reporta la telemetría de los agentes para Métricas. El paquete completo instala ambos.
CLI de HubBound
hubbound
Una herramienta de línea de comandos con una pantalla interactiva en la terminal, para quien está frente al teclado. Solo actúa cuando la ejecutas.
- Inicia tu sesión con un código de dispositivo (hubbound auth login)
- Instala un Kit o un Artifact en cada herramienta de IA compatible
- Sincroniza, actualiza, lista y desinstala lo que tiene la máquina
- Fija el tooling de un proyecto en hubbound.json y cambia configuraciones globales con perfiles
- Diagnostica y repara las integraciones con las herramientas (hubbound doctor)
Runtime de HubBound
hubboundd
Un servicio del sistema con un agente de usuario y un asistente de actualizaciones. Arranca con la máquina y trabaja según una programación.
- Sincroniza tus distribuciones e instala cada Kit o Artifact obligatorio; los opcionales esperan a que decidas
- Recibe la telemetría de tus herramientas de IA en la máquina y luego la sube para las Métricas de HubBound
- Mantiene la configuración de HubBound de cada herramienta y la repara cuando se desalinea
- Busca actualizaciones firmadas; aplicar una vuelve a pedir tu aprobación
¿Qué necesita cada máquina?
La máquina de un desarrollador: el paquete completo
Comandos cuando los quieres, sincronización y telemetría cuando no. Es la instalación recomendada.
Instalaciones manuales o con scripts: la CLI
Instala desde hubbound.json o por nombre, con --no-tui para una salida en texto plano. Nada corre en segundo plano.
Kits obligatorios sin pasos manuales: el Runtime
Las distribuciones marcadas como obligatorias llegan sin que nadie ejecute un comando. El inicio de sesión y las comprobaciones de estado usan la CLI.
Cómo funcionan las reglas de distribución
¿Cómo instala la CLI de HubBound un Kit o un Artifact?
La CLI de HubBound instala un Kit o un Artifact con un solo comando, hubbound install, que descarga la versión publicada y la escribe en cada herramienta de IA compatible de la máquina: Claude Code, Cursor, Codex CLI, GitHub Copilot y Antigravity. Los flags acotan las herramientas, el alcance o el perfil.
Un comando de instalación, parte por parte
hubbound install kit jane-a1b2c3/ai-tools-bundle@1.2.0 --scope local --tool claudecode,cursor
El comando
hubbound install
Descarga el Kit o el Artifact y conecta sus archivos con tus herramientas de IA, en un solo paso.
Qué instalar
kit
kit para un paquete, artifact para una sola skill, regla, hook, subagente o servidor MCP.
Etiqueta del autor y nombre
jane-a1b2c3/ai-tools-bundle
Cada Kit y Artifact se identifica como etiqueta-del-autor/nombre, la misma etiqueta que muestra el Marketplace.
Versión, opcional
@1.2.0
Fija una versión exacta. Si la omites, obtienes la más reciente.
Dónde se instala
--scope local
local escribe en este proyecto y registra la versión en hubbound.json; global escribe en las carpetas de tus herramientas a nivel de usuario. Sin el flag, se usa local cuando hay un hubbound.json.
En qué herramientas
--tool claudecode,cursor
Una lista separada por comas. Sin el flag, la CLI instala en las cinco.
Las cinco herramientas, con su id de --tool
- Claude Code
claudecode - Cursor
cursor - Codex CLI
codexcli - GitHub Copilot
copilot - Antigravity
antigravity
Añade --profile work para fijar la instalación en un perfil global con nombre; se instala en el momento si ese perfil está activo.
¿Cómo mantienen el archivo HubBound y los perfiles cada configuración coherente?
El archivo HubBound (hubbound.json) fija los Kits y Artifacts que necesita un proyecto, en versiones exactas o en la más reciente, así que quien clona el repositorio ejecuta hubbound install una vez y obtiene el mismo tooling. Los perfiles hacen lo mismo con las configuraciones globales: conjuntos con nombre, como trabajo y personal, que la CLI intercambia sin tocar archivos obligatorios ni ajenos a HubBound.
{"name": "my-app","artifacts": {"jane-a1b2c3/my-hook": "1.2.0"},"kits": {"jane-a1b2c3/ai-tools-bundle": "latest"}}La estructura del archivo es la que crea hubbound init. Los nombres y versiones son los ejemplos de la documentación de la CLI.
Créalo una vez
hubbound init escribe hubbound.json en la carpeta actual, con el nombre de la carpeta. Tiene dos mapas de versiones fijadas: artifacts y kits.
Súbelo al repositorio e instala desde él
Un hubbound install sin argumentos lee el hubbound.json más cercano e instala todo lo fijado, como npm install lee package.json. Las instalaciones y actualizaciones locales guardan la versión resuelta.
Cambia configuraciones globales con perfiles
Al cambiar, solo se quitan las instalaciones opcionales del perfil anterior y luego se aplica el nuevo. Nunca se tocan las instalaciones obligatorias ni los archivos sin marca de HubBound.
¿Cómo veo y corrijo lo que hay instalado en una máquina?
La CLI de HubBound muestra todo lo instalado en una máquina con hubbound manage, una pantalla interactiva en la terminal que lista cada Kit y Artifact por herramienta de IA, con su estado y si un admin o un equipo lo exige. Después, hubbound sync, upgrade, uninstall y doctor devuelven la máquina a su estado correcto.
Las etiquetas de la pantalla son las reales (la CLI está en inglés); los Artifacts listados son un ejemplo ilustrativo.
Trae tus distribuciones
Obtiene cada distribución que puedes ver y materializa sus archivos en tus herramientas.
Pasa a lo más reciente
Actualiza cada Kit y Artifact instalado y renueva las versiones fijadas en hubbound.json.
Quítalo de aquí
Limpia solo esta máquina. Añade --remote para retirar también tu propia distribución.
Arregla una integración rota
Reescribe la configuración propia de HubBound que le falta a una herramienta. hubbound doctor solo diagnostica.
¿Qué comandos incluye la CLI de HubBound?
La CLI de HubBound agrupa sus comandos en siete áreas: distribuciones, perfiles, cuenta y dispositivo, el daemon del Runtime, analítica, actualizaciones y diagnóstico. Ejecutar hubbound sin argumentos abre una pantalla interactiva en la terminal, y la mayoría de los comandos también ofrecen salida en texto plano o JSON para scripts.
Distribuciones
- hubbound manage
- Explora y gestiona todo lo instalado.
- hubbound sync
- Trae las distribuciones y materializa sus archivos.
- hubbound init
- Crea un hubbound.json en esta carpeta.
- hubbound install
- Instala un Kit o un Artifact, o todo lo fijado en hubbound.json.
- hubbound upgrade
- Actualiza un Kit o un Artifact, o todos.
- hubbound uninstall
- Quita un Kit o un Artifact de esta máquina.
- hubbound retract
- Retira tu distribución remota directa.
- hubbound list
- Lista lo instalado, sin red y sin iniciar sesión.
Perfiles
- hubbound profile create
- Crea un perfil global con nombre.
- hubbound profile switch
- Cambia el perfil global activo.
- hubbound profile list
- Lista los perfiles y cuál está activo.
Cuenta y dispositivo
- hubbound auth login
- Inicia sesión con un código de dispositivo.
- hubbound auth status
- Muestra quién tiene la sesión iniciada.
- hubbound auth logout
- Cierra la sesión y revoca este dispositivo.
- hubbound device status
- Muestra la credencial de analítica del dispositivo.
Daemon del Runtime
- hubbound daemon status
- Muestra el estado del servicio.
- hubbound daemon health
- Comprueba que el daemon responde.
- sudo hubbound daemon start
- También install, stop, restart y uninstall, como administrador.
Analítica
- hubbound analytics doctor
- Revisa la cola de subida, solo lectura.
- hubbound analytics push
- Fuerza un ciclo de subida ahora.
Actualizaciones
- hubbound update
- Busca una actualización firmada y aplícala.
- hubbound update check
- Descarga y verifica la última actualización.
- hubbound update apply --force
- Aplica la actualización preparada, con aprobación.
Diagnóstico
- hubbound doctor
- Diagnostica las integraciones sin cambios.
- hubbound doctor repair
- Repara archivos propios de HubBound que falten.
- hubbound version
- Muestra la versión instalada.
- hubbound docs
- Abre la documentación de la CLI.
Mira cómo se conecta todo.
Cada pieza de HubBound se apoya en las demás. Elige a dónde quieres ir ahora.
Lleva el tooling de tu equipo a cada máquina.
Mira cómo la CLI y el Runtime de HubBound instalan un Kit de principio a fin y mantienen cada máquina en el estándar de tu organización.
