Como Parar de Gerenciar Vários Agentes de IA no Terminal e Organizar uma Equipe com o Firstmate

Cena familiar: você abre cinco abas do terminal, cada uma executando seu próprio agente de codificação. Um corrige um teste instável, outro reescreve componentes para modo escuro, um terceiro executa uma auditoria de dependências. Dez minutos depois, o caos se instala. Qual agente terminou? Onde os testes falharam? Qual branch acabou de ser mesclada?

O projeto firstmate oferece uma abordagem diferente. Em vez de controlar manualmente cada agente, você se comunica com um assistente principal — o primeiro imediato. Você entrega tarefas a eles, e eles as distribuem para "marinheiros" autônomos em ambientes isolados.

O que é um agent distro

Os criadores do firstmate descrevem seu projeto não como outro utilitário CLI ou framework, mas como um agent distro. Essencialmente, é um conjunto portátil de instruções em formato AGENTS.md, habilidades prontas, scripts e regras comportamentais.

Você clona o repositório para sua máquina, executa sua ferramenta CLI familiar dentro dele (como Claude Code ou Grok), e ele busca dinamicamente a lógica para gerenciar toda a equipe. Nenhum aplicativo adicional ou dependência pesada precisa ser instalado no seu sistema.

Como a arquitetura funciona

A ideia inteira é construída sobre separação de responsabilidades e isolamento de espaços de trabalho.

Você dá comandos ao primeiro imediato através de um único chat. Por exemplo: "revise o projeto xyz, corrija o teste de autorização que está falhando, e adicione o modo escuro."

O primeiro imediato clona o repositório na pasta projects/ e cria tarefas.

Para cada tarefa, uma janela de terminal separada é iniciada (tmux, zellij, cmux, ou Orca) e uma árvore de trabalho git isolada é criada usando a ferramenta treehouse.

Marinheiros autônomos trabalham em paralelo, sem interferir uns nos outros ou quebrar a base de código principal.

Após as tarefas serem concluídas, o primeiro imediato coleta os resultados e entrega um pull request pronto ou relatório de pesquisa.

Um detalhe interessante: o processo de monitoramento não consome tokens de rede neural. Um script bash em segundo plano monitora o estado da sessão. Ele fica dormente até que um evento ocorra em uma das janelas ou um marinheiro precise de uma decisão humana. Só então o observador acorda o primeiro imediato e passa a ele um resumo breve.

Modos e comandos

O projeto tem habilidades integradas que são invocadas diretamente do chat:

• /afk alterna o sistema para o modo ausente. O processo em segundo plano lida com mensagens técnicas menores por conta própria, enquanto perguntas genuinamente importantes são coletadas em um resumo e preparadas para o seu retorno.
• /bearings gera um resumo breve de todas as tarefas em execução e pull requests ativos.
• /ahoy ajuda você a se atualizar rapidamente mostrando a linha do tempo de eventos e questões que requerem sua aprovação.
• /stow processa o contexto acumulado, salva conhecimento importante em disco e arquiva dados desatualizados, economizando o orçamento de tokens.

Além do desenvolvimento padrão com criação de PR, o firstmate tem um modo de pesquisa (scout). Se você precisa auditar segurança ou explorar o módulo de outra pessoa em vez de mudar código, o marinheiro compilará um relatório detalhado em um arquivo Markdown sem modificar o repositório.

Agentes suportados e inicialização

O repositório está bem preparado para trabalhar com ferramentas CLI populares. Claude Code, Grok e Pi são oficialmente recomendados como o primeiro imediato principal. Codex e OpenCode também foram testados.

Tmux é usado como backend de terminal padrão, mas zellij, cmux e Orca também são suportados.

A inicialização rápida fica assim:

gh auth login
git clone https://github.com/kunchenguid/firstmate
cd firstmate
claude

Após a inicialização, o Claude Code buscará instruções de AGENTS.md, e você só precisará cumprimentá-lo com ahoy!.

Para quem é este projeto

Se você só usa assistentes de IA ocasionalmente para refatoração menor de uma única função, o firstmate pode parecer excessivo. Mas quando trabalha ativamente em paralelo em múltiplas tarefas, o projeto economiza muito tempo. O isolamento via git worktree impede que alterações sejam sobrescritas, e um único chat com o primeiro imediato elimina a necessidade de alternar constantemente entre uma dúzia de janelas.