Instalación

vexillum soporta macOS y Linux, en amd64 y arm64.

RequisitosCopiar enlace

• macOS o Linux, amd64 o arm64 (Windows no está soportado)
• Claude Code, instalado y con sesión iniciada (suscripción o API key), para el commander y los soldiers por defecto
• herdr (brew install herdr funciona)
• un repositorio git para tu proyecto
• opcional: gh (para vx ship)
• opcional: Pi u OpenCode, para correr en ellos el commander o los soldiers de un perfil de modelo (ver Pi como commander, OpenCode como commander y Modelos para otros harnesses); un proyecto cuyo commander no es Claude Code necesita acá su propio CLI

vx doctor verifica que estén presentes el CLI de cada harness de commander del proyecto (Claude Code por defecto), herdr y git, y que el scaffold del proyecto esté sano. No verifica que Claude Code tenga la sesión iniciada, tu SO o arquitectura, ni que estés dentro de un pane de herdr; vx dispatch solo funciona dentro de un pane de herdr.

Instalá el binarioCopiar enlace

brew install isaias-alt/tap/vexillum

Este script:

1. Detecta tu sistema operativo y arquitectura;
2. Usa Homebrew si brew está en tu PATH (brew install isaias-alt/tap/vexillum, o brew upgrade cuando la fórmula ya está instalada);
3. Si no, descarga el archivo del release para tu plataforma y verifica su checksum sha256 contra el checksums.txt del release, y se niega a instalar si no coincide;
4. Instala el binario en /usr/local/bin, o en ~/.local/bin cuando no podés escribir en /usr/local/bin (avisa si ese directorio no está en tu PATH);
5. Comprueba que ahora existe un vx que funciona (en el directorio de instalación, el prefijo de Homebrew o tu PATH) y termina con un error si no.

Sin opciones instala el último release stable y nunca un pre-release. Para probar un build canary o instalar una versión exacta, pasá --channel canary o --version <tag>; las dos son descargas directas que se saltean Homebrew. Ver Canales de release.

Comprobá que funcionó:

vx --version

Para actualizar el binario más adelante, corré vx upgrade. Ver Actualización.

Instalá lo que vexillum orquestaCopiar enlace

vexillum no instala sus herramientas; las verifica.

Corré la verificación cuando quieras:

vx doctor

doctor es de solo lectura. Imprime [ok] o [missing] por cada herramienta, la versión de herdr, ~/.vexillum/, si el proyecto actual está inicializado y es un repositorio git, y, para un proyecto inicializado, el estado del bloque de vexillum en AGENTS.md o CLAUDE.md, si CLAUDE.md importa AGENTS.md (cuando el bloque está en AGENTS.md), cada skill, si models.json es válido, y el hook Stop del sentinel: si está registrado, si encuentra vx desde un entorno mínimo y si hay un sentinel corriendo:

[ok] AGENTS.md vexillum block - current (en)
[ok] CLAUDE.md imports AGENTS.md
[ok] skill vexillum - installed, current
[ok] models.json - valid, 5 profiles
[ok] sentinel Stop hook - registered in .claude/settings.json
[ok] sentinel Stop hook finds vx - found with a minimal environment
[ok] sentinel - running, 1 sentinel await(s) waiting

Sale con código distinto de cero cuando falla un chequeo requerido. Un hook Stop que no encuentra vx es un [warn] con el arreglo, nunca un fallo.

Solución de problemas: cuarentena en macOSCopiar enlace

Un tarball descargado en el navegador y extraído con doble clic recibe un atributo de cuarentena, y la primera ejecución puede quedar bloqueada ("no se puede verificar el desarrollador"). Quitalo con:

xattr -d com.apple.quarantine "$(command -v vx)"

Homebrew y el instalador de curl no tienen este problema.