Install
npm install --global @escoffier-labs/[email protected]
brigade setupPara quién es
- Para desarrolladores que usan varios agentes de codificación a la vez: al alternar entre varios harnesses (por ejemplo, usando un agente de codificación distinto según el momento), quieres que las herramientas y la memoria permanezcan sincronizadas y que todo el trabajo comparta un mismo registro, en lugar de que cada herramienta lleve el suyo con estados que no se comunican. La descripción oficial: ejecutar agentes de codificación en cualquier lugar y conservar un solo registro del trabajo.
- Se ofrece como CLI: los agentes reclaman trabajo listo desde un registro compartido, y la memoria y las habilidades se sirven a los harnesses vía MCP. Encaja con quienes se sienten cómodos gestionando el estado del trabajo de los agentes en la línea de comandos y conectando capacidades a una cadena de herramientas de agentes existente mediante MCP.
- El registro de trabajo se guarda en archivos locales y no necesita demonio, ideal para quien quiere que sus datos de trabajo permanezcan en su propia máquina y no desea ejecutar servicios en segundo plano adicionales. Si se admite colaboración multiusuario o despliegue remoto no consta oficialmente.
- Requisito previo: la vía de instalación con npm exige Node.js 22 o más reciente y npm. Si el entorno no los cumple, la documentación oficial no ofrece otra forma de instalación ni explica si hay diferencias entre sistemas operativos.
- La documentación oficial no enumera los casos en los que no encaja ni da la lista de harnesses compatibles. Antes de conectarlo, comprueba que tu cliente de agente pueda añadir un servidor MCP por stdio; la documentación oficial no lo comprueba por ti. Si tu cadena de herramientas no puede ejecutar una CLI ni conectarse a MCP, por ahora no hay ruta de integración verificable.
Primer intento en 3 minutos
- Requisitos: ten a mano Node.js 22 o más reciente y npm. La documentación oficial señala que el uso puede enviar una solicitud de versión pasiva (passive version request) como efecto secundario de telemetría; es el efecto de red declarado explícitamente por el proveedor, una condición que se acepta antes de usarlo, y conviene saberlo al instalar. Más allá de esto, si existe algún otro acceso a la red no consta en la información disponible.
- Solo hay un camino principal recomendado: instalar globalmente el paquete con versión fijada mediante npm y luego inicializar siguiendo los pasos oficiales:
npm install --global @escoffier-labs/[email protected]
brigade setup
- Lanzar el primer intento: haz que el agente ejecute
brigade work claim --next --actor codexpara reclamar un trabajo listo del registro compartido; es el flujo central que muestra la documentación oficial. Ojo: reclamar es una acción de «llevarse el trabajo listo». Cómo cambia su estado en el registro después y si se puede deshacer no se indica; trátalo como una operación que afecta al registro. - Si aún no quieres que el agente reclame trabajo, arranca primero
brigade memory serve-mcp --stdioen local, en modo stdio, conéctalo a tu harness como servidor MCP y observa si puedes leer la memoria y las habilidades de Brigade vía MCP; este paso no implica ninguna reclamación. - Señal de éxito: el agente obtiene un trabajo listo mediante el comando de reclamación, o el harness lee la memoria y las habilidades de Brigade vía MCP. El comportamiento concreto de brigade setup y su salida en caso de éxito no se describen oficialmente; si el comando no se comporta como esperabas, confirma primero que tu versión de Node.js cumple el requisito y coteja los pasos con el repositorio oficial.
Casos de uso
- Caso 1: varios agentes comparten un mismo registro de trabajo. Escenario: usas más de un agente de codificación y quieres un único lugar donde quede quién hace qué y hasta dónde, en vez de que todo quede disperso en sesiones separadas y pierdas contexto al cambiar de herramienta. Inicio: tras la instalación y brigade setup, haz que el agente ejecute
brigade work claim --next --actor codexal comenzar una tarea. Flujo: work claim — el agente reclama un trabajo listo del registro compartido. Qué esperar: el trabajo queda reclamado y el registro se guarda en archivos locales sin demonio. Cómo se actualiza el registro tras la reclamación y cómo consultar todo el trabajo no se indica oficialmente; hoy lo verificable llega hasta el paso de reclamación. - Caso 2: servir la memoria y las habilidades a un harness. Escenario: quieres que el harness use, al procesar tareas, la memoria y las habilidades que mantiene Brigade, en lugar de que cada herramienta conserve las suyas sin conexión entre sí. Inicio: arranca
brigade memory serve-mcp --stdioen modo stdio y conéctalo al harness como servidor MCP. Flujo: memory serve-mcp — Brigade expone por ese servidor la memoria y las habilidades al harness. Qué esperar: el harness puede leer memoria y habilidades vía MCP. Cómo registra tu cliente un servidor MCP por stdio y qué interfaces invocables existen tras conectarlo no se indica oficialmente; conéctalo de la forma habitual de tu harness y verifica después.
Límites de uso
- Acceso a la red: la documentación oficial indica que puede enviarse una solicitud de versión pasiva como telemetría, y esto lo divulga el propio proveedor; más allá de eso, si hay otros accesos a la red no se indica, así que no lo trates como una herramienta local totalmente sin conexión.
- Archivos y efectos secundarios: el registro de trabajo se guarda en archivos locales, sin demonio; reclamar se lleva un trabajo listo del registro compartido y no se indica si se puede deshacer. Qué cambios hacen en el sistema la instalación y brigade setup no se detalla punto por punto.
- Entorno de ejecución y cliente: la vía npm exige Node.js 22 o más reciente y npm; la lista de harnesses compatibles no está confirmada y si el tuyo funciona deberás comprobarlo tú.
- Versión y otras cuestiones: el comando de instalación queda fijado en 0.30.0; otras versiones y formas de actualizar no están confirmadas. Cómo añadir trabajo, consultar todo el trabajo o escribir en la memoria y las habilidades más allá de reclamar no lo cubre la información oficial disponible. Antes de integrarlo en tu flujo diario, pruébalo a pequeña escala, confirma que el comportamiento cumple las expectativas y solo entonces amplía el uso.