vexillum
para agentes de código

Un commander. Muchos soldiers.

vexillum orquesta agentes de código desde tu terminal. Un commander despacha soldiers a camps aislados y un sentinel vigila lo que necesita tu atención.

brew install isaias-alt/tap/vexillum
leer la documentación
mirá cómo funciona

Todo el ciclo, como una conversación.

Cinco momentos de una sesión con el commander en Claude Code. Hacé clic en uno, o simplemente mirá.

  1. I

    Pedí el trabajo con palabras simples. El commander manda una mission y un scout, cada uno a su propio camp.

    Documentación →
  2. II
  3. III
  4. IV
  5. V
~/project - commander01 / 05
despachá un soldier para refactorizar el módulo de pagos y un scout para rastrear la pérdida de memoria
A la orden, general. Una mission y un scout en camino.
Bash(vx dispatch "refactor the payment module" --kind mission --model sonnet)
task_id=7c1e9a40d3b2f658 kind=mission camp_slot=1
still running
Bash(vx dispatch "trace the memory leak" --kind scout)
task_id=e41b07d9a52c3f86 kind=scout camp_slot=2
Los dos soldiers están en el campo, general. La mission trabaja en el camp 1 y el scout en el camp 2 (solo investiga, no toca tu código). Seguí hablándome, el sentinel me avisa cuando alguno termine.
el vocabulario

Cada parte de vexillum tiene un rol en el campo.

general
El humano - vos. Habla solo con el commander; nunca maneja a los soldiers directamente.
commander
El orquestador que corrés. Lee una mission, despacha soldiers y sigue su progreso.
soldier
Un subagente que corre el commander. Cada uno trabaja una tarea de forma independiente, dentro de su propio camp.
camp
El espacio de trabajo aislado de un soldier - su propio worktree, así que soldiers en paralelo nunca chocan.
sentinel
Vigila a los soldiers en ejecución y despierta al commander cuando uno termina, se bloquea o es interrumpido.
mission / scout
Los dos tipos de tarea que puede correr un commander: una mission ejecuta trabajo, un scout investiga y reporta.
el ciclo de mando

Cómo un prompt se vuelve muchos soldiers.

Le hablás a un solo commander. Él despacha soldiers a camps aislados y un sentinel los vigila en segundo plano, así el commander despierta solo cuando uno termina.

generalvoscommanderClaude Codepedidoreporte1vx landvx ship6vx dispatch2camp 1soldiermissioncamp 2soldierscoutcamp Nsoldiermission3sondea4sentinelen segundo planodespierta al commanderal terminar un soldier5
  1. Le decís al commander lo que querés.
  2. Despacha soldiers con vx dispatch, uno por tarea.
  3. Cada soldier trabaja solo en su propio camp, un git worktree.
  4. El sentinel sondea cada camp en segundo plano.
  5. Cuando un soldier termina (listo, bloqueado o interrumpido) el sentinel despierta al commander.
  6. El commander te reporta, o te pregunta si hace vx land o vx ship.

Dos formas de salir de un camp.

Land se queda en tu máquina. Ship corre el tribunal y abre un pull request real.

mission listavx landvx shiprevisás vossin pipelinetribunallint · testsreview · docsfast-forwardtu checkoutpush + abrir PRllega a GitHub

Estado a prueba de reinicios.

Todo vive en disco, en ~/.vexillum, escrito de forma atómica. Matá al commander o al sentinel y el siguiente retoma donde quedó.

sentinelantescommanderantesreiniciosentinelcommanderreconciliado desde disco~/.vexillumtasks y wakes, JSON atómico
despacho

Ninguna interfaz nueva que aprender.

Ya hablás con tu commander en Claude Code. Pedile que despache un soldier y él llama a vx por vos.

despachá un soldier para refactorizar el módulo de pagos
Bash(vx dispatch "refactor the payment module" --kind mission --model sonnet)
task_id=7c1e9a40d3b2f658 kind=mission camp_slot=1
still running
y que alguien rastree esa pérdida de memoria, solo que investigue por ahora
Bash(vx dispatch "trace the memory leak" --kind scout)
task_id=e41b07d9a52c3f86 kind=scout camp_slot=2
código abierto

¿Encontraste un bug? ¿Querés ayudar?

abrir un issueleer CONTRIBUTING