Quickstart

Necesitás vexillum, Claude Code (el commander por defecto; Pi y OpenCode también sirven, mirá Pi como commander y OpenCode como commander) y herdr instalados. Ver Instalación.

1. Preparar tu proyectoCopiar enlace

Desde la raíz de un repositorio git:

vx init

init cambia archivos tuyos, así que te dice cuáles y pregunta antes. Paso a paso:

1. Dónde va el bloque. Si el proyecto no tiene AGENTS.md, init propone poner el bloque de vexillum en CLAUDE.md en vez de crear un AGENTS.md:

   Copiar

   This project has no AGENTS.md. Put the vexillum block in CLAUDE.md instead of creating an AGENTS.md? [Y/n]

   La respuesta por defecto es sí (CLAUDE.md se crea si no existe). Si respondés n, se crea un AGENTS.md. Cuando el proyecto ya tiene un AGENTS.md, la pregunta no se hace y el bloque va ahí. Ver El slot de AGENTS.md.

2. El aviso. Lista los archivos tuyos que está por cambiar, y después los archivos propios de vexillum:

   Copiar

   vx init will change these files of yours in /path/to/project:
     CLAUDE.md                  create it with the vexillum block
     .claude/settings.json      add the sentinel Stop hook
   It also writes vexillum's own files: .vexillum/config.json; .vexillum/.gitignore; .vexillum/models.json; .claude/skills/ (vexillum, forum and muster, you are asked first).
   Continue? [Y/n]

   Si respondés n, no se cambia nada.

3. El slot de AGENTS.md. El núcleo del commander se escribe entre marcadores en el archivo que elegiste (CLAUDE.md por defecto, o AGENTS.md), en el idioma que detecta ahí. Confirmás o cambiás el idioma.

4. El import en CLAUDE.md. Solo cuando el bloque está en AGENTS.md: CLAUDE.md recibe la línea @AGENTS.md para que Claude Code vea el bloque. Un CLAUDE.md existente se edita solo después de una segunda pregunta.

5. Las skills. Install the vexillum, forum and muster skills? [Y/n]. Si decís que sí, las escribe en .claude/skills/.

6. models.json. .vexillum/models.json se escribe con los perfiles de modelo y effort por defecto. Uno existente nunca se pisa.

7. El hook del sentinel. Un hook Stop asíncrono en .claude/settings.json (un comando de una línea que corre vx sentinel await y encuentra vx sin depender de tu PATH) permite al sentinel despertar al commander. Los settings y hooks existentes se fusionan, nunca se pisan.

También crea ~/.vexillum/ si falta, y volver a correr init no cambia nada de lo que ya está en su lugar.

Sin terminal (scripts, CI) init no pregunta nada y no cambia nada salvo que pases --yes:

vexillum se instala solo por proyecto: corré init en cada proyecto que quieras orquestar.

2. Verificar el entornoCopiar enlace

vx doctor

Todo lo requerido debería decir [ok].

3. Iniciar el commander dentro de herdrCopiar enlace

Abrí un pane de herdr, hacé cd al proyecto e iniciá tu commander (Claude Code por defecto). vx dispatch necesita HERDR_WORKSPACE_ID, que herdr define en los panes que administra; fuera de uno se niega a despachar.

4. Pedir trabajoCopiar enlace

> dispatch a soldier to fix the flaky login test

El commander corre vx dispatch "fix the flaky login test" --kind mission, que imprime el id de la tarea, la branch del camp (vexillum/<task-id>) y status=running. El primer dispatch también inicia el sentinel en segundo plano.

Podés seguir hablando con el commander mientras el soldier trabaja. Esa es la magia de vexillum.

5. EnterarteCopiar enlace

Cuando el soldier termina (done o blocked), el sentinel despierta al commander, que te reporta. Para mirar vos mismo:

vx status

6. AterrizarlaCopiar enlace

Cuando la mission está done, revisala y decile al commander que la aterrice. Corre:

vx land <task-id>

Eso hace fast-forward de tu checkout hasta la branch de la mission y devuelve el camp al pool. Si preferís un pull request revisado, ver Land vs ship.