Brigade: sincronize ferramentas e memória entre harnesses e unifique o registro de trabalho dos seus agentes de codificação em arquivos locais

Para quem é

• Para desenvolvedores que usam vários agentes de codificação ao mesmo tempo: ao alternar entre vários harnesses (por exemplo, usando um agente de codificação diferente em cada momento), você quer que as ferramentas e a memória permaneçam sincronizadas e que todo o trabalho compartilhe um mesmo registro, em vez de cada ferramenta manter o seu com estados que não se conversam. A descrição oficial: executar agentes de codificação em qualquer lugar e manter um só registro do trabalho.
• Ele vem como CLI: os agentes assumem trabalho pronto a partir de um registro compartilhado, e a memória e as habilidades são servidas aos harnesses via MCP. Serve para quem se sente à vontade para gerenciar o estado do trabalho dos agentes na linha de comando e conectar capacidades a uma cadeia de ferramentas de agentes existente via MCP.
• O registro de trabalho fica em arquivos locais e não precisa de daemon, o que combina com quem quer manter os dados de trabalho na própria máquina e não quer rodar serviços em segundo plano extras. Se há suporte a colaboração multiusuário ou implantação remota, não há declaração oficial.
• Pré-requisito: o caminho de instalação via npm exige Node.js 22 ou mais recente e npm. Se o ambiente não atender, a documentação oficial não oferece outro método de instalação nem explica se há diferenças entre sistemas operacionais.
• A documentação oficial não lista os casos em que não serve nem traz a lista de harnesses compatíveis. Antes de conectar, confirme que seu cliente de agente consegue adicionar um servidor MCP via stdio — a documentação oficial não verifica isso por você. Se a sua cadeia de ferramentas não consegue executar uma CLI nem se conectar a MCP, por ora não há caminho de integração confirmável.

Primeira tentativa em 3 minutos

• Pré-requisitos: tenha em mãos Node.js 22 ou mais recente e npm. A documentação oficial afirma que o uso pode enviar uma requisição de versão passiva (passive version request) como efeito colateral de telemetria; esse é o efeito de rede declarado explicitamente pelo fornecedor, uma condição que se aceita antes de usar, e vale conhecê-la na instalação. Além disso, se há outros acessos à rede, as informações disponíveis não dizem.
• Há um único caminho principal recomendado: instale globalmente o pacote com versão fixada via npm e depois inicialize seguindo os passos oficiais:

npm install --global @escoffier-labs/[email protected]
brigade setup

• Dispare a primeira tentativa: faça o agente executar brigade work claim --next --actor codex para assumir um trabalho pronto do registro compartilhado — esse é o fluxo central mostrado oficialmente. Atenção: assumir é uma ação de “levar embora o trabalho pronto”. Como o estado dele muda no registro depois e se é possível desfazer não é informado; trate como uma operação que afeta o registro.
• Se ainda não quiser que o agente assuma trabalho, inicie primeiro brigade memory serve-mcp --stdio localmente, em modo stdio, conecte-o ao seu harness como servidor MCP e observe se consegue ler a memória e as habilidades do Brigade via MCP — esta etapa não envolve assumir trabalho.
• Sinal de sucesso: o agente obtém um trabalho pronto pelo comando de assumir, ou o harness lê a memória e as habilidades do Brigade via MCP. O comportamento concreto do brigade setup e sua saída em caso de sucesso não são descritos oficialmente; se o comando não se comportar como esperado, confirme primeiro que a versão do Node.js atende ao requisito e confira os passos no repositório oficial.

Casos de uso

• Caso 1: vários agentes compartilhando um mesmo registro de trabalho. Cenário: você usa mais de um agente de codificação e quer um lugar único que mostre quem está fazendo o quê e até onde, em vez de tudo espalhado em sessões separadas, perdendo contexto a cada troca de ferramenta. Início: após a instalação e o brigade setup, faça o agente executar brigade work claim --next --actor codex ao começar uma tarefa. Fluxo: work claim — o agente assume um trabalho pronto do registro compartilhado. O que esperar: o trabalho fica assumido e o registro é guardado em arquivos locais sem daemon. Como o registro é atualizado depois de assumir e como consultar todo o trabalho não é informado oficialmente; hoje o confirmável vai até a etapa de assumir.
• Caso 2: servir memória e habilidades a um harness. Cenário: você quer que o harness use, ao processar tarefas, a memória e as habilidades mantidas pelo Brigade, em vez de cada ferramenta manter as suas, sem comunicação entre si. Início: inicie brigade memory serve-mcp --stdio em modo stdio e conecte-o ao harness como servidor MCP. Fluxo: memory serve-mcp — o Brigade expõe por esse servidor a memória e as habilidades ao harness. O que esperar: o harness consegue ler memória e habilidades via MCP. Como seu cliente registra um servidor MCP via stdio e quais interfaces chamáveis existem depois da conexão não é informado oficialmente; conecte da forma habitual do seu harness e verifique depois.

Limites de uso

• Acesso à rede: a documentação oficial diz que uma requisição de versão passiva pode ser enviada como telemetria, e isso é divulgado proativamente pelo fornecedor; além disso, se há outros acessos à rede não há declaração, portanto não o trate como uma ferramenta local totalmente offline.
• Arquivos e efeitos colaterais: o registro de trabalho fica em arquivos locais, sem daemon; assumir leva embora um trabalho pronto do registro compartilhado e não se informa se é reversível. Quais alterações a instalação e o brigade setup fazem no sistema não é listado item a item.
• Ambiente de execução e cliente: o caminho npm exige Node.js 22 ou mais recente e npm; a lista de harnesses compatíveis não está confirmada, e cabe a você verificar se o seu funciona.
• Versão e outros: o comando de instalação fica fixado em 0.30.0; outras versões e formas de atualização não estão confirmadas. Como adicionar trabalho, consultar todo o trabalho ou gravar na memória e nas habilidades além de assumir não é coberto pelas informações oficiais disponíveis. Antes de incorporá-lo à sua rotina, teste em pequena escala, confirme que o comportamento corresponde às expectativas e só então amplie o uso.