Como Domar o Caos de Dezenas de Agentes de IA em Um Projeto

Recentemente tentei executar o Claude Code para refatorar um módulo e o GitHub Copilot CLI para reescrever testes ao mesmo tempo. Perdi-me rapidamente nas abas do terminal, e branches locais sobrescreveram acidentalmente as mudanças umas das outras. Parece que os criadores do projeto Kandev enfrentaram o mesmo problema quando decidiram construir sua própria ferramenta para gerenciar desenvolvedores de IA.

Kandev é uma plataforma aberta com interface web e quadro Kanban que transforma o trabalho caótico com codificadores autônomos em um processo claro e controlado.

Qual é a ideia principal

No último ano, surgiram muitos utilitários CLI para codificação: Claude Code, Codex, Copilot CLI, Gemini, Cursor agent, Devin, e mais algumas dezenas de alternativas. Cada um tem seus próprios pontos fortes, mas quando você os executa diretamente no terminal do seu laptop, surgem complicações padrão:

1. As mudanças são inconvenientes de revisar através da saída do console.
2. Executar múltiplos agentes em paralelo na mesma pasta leva a conflitos no Git.
3. A carga na CPU e RAM local aumenta a cada novo processo.

Os desenvolvedores do Kandev propõem uma abordagem diferente: uma pessoa define tarefas, distribui elas entre colunas no quadro e revisa os diffs finais, enquanto toda a geração rotineira permanece com as redes neurais.

O projeto não está vinculado à nuvem de nenhum fornecedor específico e é distribuído sob a licença AGPL-3.0. Não há coleta de telemetria, e você pode executar o servidor no seu próprio hardware ou em uma VPS isolada.

Tarefas paralelas sem conflitos de branches

Para evitar que os agentes interfiram uns com os outros e corrompam o diretório de trabalho, o Kandev usa ativamente mecanismos de Git worktree. Cada card recebe seu próprio ambiente isolado com sua própria branch. Você pode executar três redes neurais diferentes simultaneamente: uma corrigirá o layout, a segunda reescreverá as consultas SQL e a terceira cuidará da documentação.

A tela do workspace dentro do Kandev é disposta como um IDE familiar. Uma janela contém:

• chat com o agente ou terminal CLI direto;
• editor de código integrado com suporte LSP;
• painel de árvore de arquivos e mudanças do Git;
• janela de preview do resultado no navegador.

Graças a esse layout, você visualiza o resultado final e o diff em um editor visual normal, em vez de tentar analisar linhas intermináveis de texto no console.

Construindo cadeias de diferentes provedores

Um recurso interessante do Kandev é criar pipelines de múltiplas redes neurais. A ferramenta suporta o ACP (Agent Client Protocol) aberto, através do qual mais de vinte agentes diferentes se conectam.

Se desejar, você pode configurar o processamento de tarefas passo a passo:

1. Claude Code projeta a arquitetura e cria um plano.
2. GitHub Copilot gera código com base no plano compilado.
3. Codex verifica as mudanças recebidas quanto a erros e vulnerabilidades.

Se a ferramenta ainda não suportar ACP diretamente, o Kandev o executa no modo TUI diretamente dentro do emulador de terminal PTY integrado. Isso significa que você pode adicionar qualquer script de console literalmente em poucos minutos através das configurações de perfil.

Trabalhando com múltiplos repositórios e subtarefas

Frequentemente uma tarefa afeta simultaneamente o backend e o frontend. O Kandev pode vincular um card a múltiplos repositórios. O sistema criará um worktree separado para cada projeto, gerará branches e coletará as mudanças agrupadas em uma única janela de revisão.

Se uma tarefa se tornar muito grande, o agente pode gerar subtarefas que herdam o contexto da sessão pai. Isso ajuda quando você precisa dividir uma grande refatoração em vários pull requests independentes.

O projeto também possui suporte integrado para MCP (Model Context Protocol). Os agentes dentro do Kandev obtêm acesso a ferramentas utilitárias: eles podem criar subtarefas, enviar mensagens para cards vizinhos e ler o histórico de diálogo de outros agentes.

Onde executar os próprios agentes

Bases de código pesadas requerem recursos consideráveis. Se você executar três agentes autônomos em um laptop, os ventiladores imediatamente começarão a girar no máximo. O Kandev resolve isso com seleção flexível de runtime.

O servidor envia tarefas para execução em diferentes ambientes:

• processo local no seu computador;
• container Docker isolado;
• servidor remoto via SSH;
• emuladores em nuvem como sprites. dev.

Você pode fazer deploy do Kandev em um servidor poderoso no escritório ou em casa, e gerenciar cards e revisar diffs até mesmo de um smartphone via navegador. Para conexão segura a partir de uma rede externa, os autores recomendam usar Tailscale ou qualquer VPN familiar.

Detalhes técnicos internos

A arquitetura do Kandev é bastante direta. O backend é escrito em Go e lida com orquestração de processos, ciclo de vida das tarefas e gateway WebSocket. Todo o banco de dados e histórico de sessão são armazenados localmente em SQLite em ~/.kandev.

O frontend é construído com React usando Vite e Zustand para gerenciamento de estado. Monaco Editor é usado para trabalho com código, xterm.js para o terminal, e a grade flexível de janelas é construída na biblioteca dockview.

A equipe também está desenvolvendo uma aplicação desktop em Tauri para quem prefere uma janela separada em vez de uma aba do navegador.

Atualmente em desenvolvimento está uma camada de autonomia chamada Office mode. Este é um modo para equipes de agentes permanentes com seus próprios papéis, limites de orçamento, memória e transferência automática de tarefas entre agentes.

Início rápido

Você pode instalar a ferramenta com alguns comandos. Para macOS e Linux, um pacote Homebrew está disponível:

brew install kdlbs/kandev/kandev
kandev

Se preferir Node.js, iniciar via npx fará tudo em uma etapa:

npx kandev@latest

Para usuários de Windows, existe o Scoop:

scoop bucket add kandev https://github.com/kdlbs/scoop-kandev
scoop install kandev
kandev

Após a inicialização, o servidor iniciará a interface web, preparará o SQLite e permitirá que você anexe imediatamente repositórios locais ou remotos.

Para quem este projeto é útil

O Kandev provavelmente não será necessário para quem apenas ocasionalmente pede a um chatbot para gerar um pequeno script. Mas economizará muito esforço se você:

• usa ativamente agentes CLI no desenvolvimento diário;
• quer executar tarefas em paralelo sem perder o controle sobre os commits;
• prefere manter código-fonte e dados de sessão nos seus próprios servidores;
• está procurando uma forma de descarregar geração de código pesada do seu laptop para uma máquina remota.

O projeto ainda é jovem, com pouco mais de 500 estrelas no GitHub, mas a ideia de combinar Kanban, Git worktree e diferentes redes neurais em uma única interface parece bastante pronta para uso.