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

Descargar 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.exe

El 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.

Comprueba que funciona

  1. La CLI responde con su versión
  2. El Runtime está en marcha (se comprueba con la CLI)
  3. Inicia sesión en tu organización

¿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

  1. El comando

    hubbound install

    Descarga el Kit o el Artifact y conecta sus archivos con tus herramientas de IA, en un solo paso.

  2. Qué instalar

    kit

    kit para un paquete, artifact para una sola skill, regla, hook, subagente o servidor MCP.

  3. 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.

  4. Versión, opcional

    @1.2.0

    Fija una versión exacta. Si la omites, obtienes la más reciente.

  5. 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.

  6. 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 Codeclaudecode
  • Cursorcursor
  • Codex CLIcodexcli
  • GitHub Copilotcopilot
  • Antigravityantigravity

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.

hubbound.json
Ejemplo ilustrativo
{"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.

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.