kunchenguid/firstmate

O que é?

Recursos principais

• 01Converse com um first mate, que distribui e supervisiona crewmates em paralelo.
• 02Cada tarefa é executada em sua própria worktree Git descartável, evitando conflitos entre trabalhos paralelos no mesmo repositório.
• 03Os crewmates rodam em janelas visíveis do tmux ou em outros backends de sessão compatíveis, que você pode acompanhar ou acessar.
• 04Os modos definidos por projeto controlam se o trabalho é entregue por meio de um PR, de um PR direto ou de uma mesclagem apenas local.
• 05Secondmates persistentes opcionais podem rodar em ambientes isolados localmente ou em hosts acessíveis por SSH.
• 06Um watcher orientado a eventos desperta o first mate somente quando é necessária uma decisão.

Casos de uso

• Executar várias correções de bugs ou tarefas de implementação de funcionalidades em diferentes repositórios ao mesmo tempo.
• Delegar investigações ou auditorias de bases de código a agentes e receber um relatório por escrito.
• Coordenar vários agentes de programação em uma única sessão de chat, sem ter que alternar entre terminais.
• Dividir cargas de trabalho maiores entre secondmates persistentes em máquinas diferentes.

Início rápido

1. 1

   Autentique o GitHub CLI

   gh auth login
2. 2

   Clone o repositório do firstmate

   git clone https://github.com/kunchenguid/firstmate
3. 3

   Acesse o diretório clonado

   cd firstmate
4. 4

   Inicie um harness compatível, como o Claude Code; a partir daí, o AGENTS.md assume o controle

   claude

Antes de usar

• !Não é um aplicativo independente: ele é executado dentro de um harness de agente de programação compatível, como Claude Code, Grok ou Pi.
• !Requer o GitHub CLI autenticado e o tmux ou outro backend de sessão compatível.
• !Alguns backends e recursos, como Zellij, cmux e T3 Code, estão marcados como experimentais.

Em coleções

Tópicos

Perguntas frequentes

O que é firstmate?

Uma distribuição de agentes para coordenar uma equipe de agentes de programação: você conversa com um first mate, que distribui tarefas em paralelo em worktrees Git isoladas e sessões no estilo tmux. firstmate é um diretório portátil de instruções, skills e scripts auxiliares que transforma um agente de programação de terminal de uso geral em coordenador de uma equipe de agentes. Não é preciso instalar um app: basta clonar o repositório e iniciar nele um harness compatível, como Claude Code, Grok, Pi, Codex ou OpenCode; essa sessão passa a ser o first mate. Você descreve o trabalho no chat, e o first mate inicia crewmates autônomos, cada um em sua própria sessão visível e em uma worktree Git limpa, e os supervisiona até que produzam um PR, uma mesclagem local aprovada ou um relatório de investigação.

firstmate é gratuito? Qual é a licença?

firstmate é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

firstmate ainda é mantido?

Manutenção ativa. O último commit de firstmate foi em 6 de nov. de 2026.

Para que posso usar firstmate?

Executar várias correções de bugs ou tarefas de implementação de funcionalidades em diferentes repositórios ao mesmo tempo. Delegar investigações ou auditorias de bases de código a agentes e receber um relatório por escrito. Coordenar vários agentes de programação em uma única sessão de chat, sem ter que alternar entre terminais. Dividir cargas de trabalho maiores entre secondmates persistentes em máquinas diferentes.

Como instalar firstmate?

Autentique o GitHub CLI: gh auth login Clone o repositório do firstmate: git clone https://github.com/kunchenguid/firstmate Acesse o diretório clonado: cd firstmate Inicie um harness compatível, como o Claude Code; a partir daí, o AGENTS.md assume o controle: claude

Onde consigo firstmate?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kunchenguid/firstmate