# Como funciona um ADE: da tarefa ao código entregue no Tallos > Um ADE funciona assim: cada tarefa ganha um workspace isolado, um agente de IA trabalha dentro dele e o resultado passa pela sua revisão antes de qualquer merge. No Tallos, você conecta os agentes que já usa, abre cada tarefa num git worktree, roda vários agentes em paralelo, vê o app e revisa o diff, e só então abre o PR ou descarta a cópia. - Canonical: https://runtallos.com/pt/como-funciona - English: https://runtallos.com/how-it-works.md - Autor: [Roberto Rocha](https://www.instagram.com/robertorochamkt/) - Atualizado em: 2026-09-30 ## Em resumo - Uma tarefa = um git worktree, uma branch e terminais próprios - Agentes começam no modo manual e pedem antes de rodar comandos - Notas no diff voltam para o agente de uma vez - Squads: um agente líder e até 12 membros - Nada é mesclado até você fazer commit, abrir o PR e mesclar ## Como funciona um ADE? Um **ADE (ambiente de desenvolvimento agêntico)** funciona como um ciclo: a tarefa vira um workspace isolado, um agente trabalha lá dentro e você revisa o diff antes de qualquer coisa chegar na branch principal. O agente escreve o código; o ADE cuida de isolamento, sessões, status, preview e revisão. O Tallos é esse ciclo num app desktop para macOS 13+ e Windows 10+. Ele não tem modelo próprio: roda os agentes CLI que você já usa, como Claude Code, Codex ou Gemini CLI, com suas assinaturas e chaves de API. Termo novo? Comece por [o que é um ADE](https://runtallos.com/pt/o-que-e-um-ade). ## O que acontece entre a tarefa e o código entregue? Todo trabalho no Tallos segue os mesmos nove passos. Você entra para descrever, responder e decidir. 1. **Conecte seus agentes** — Abra Configurações → Conexões. Cada card de agente instala o CLI com o comando verificado do fornecedor, abre o login ou salva uma chave de API só para aquele agente e lista os modelos. Veja [conexões de agentes](https://runtallos.com/pt/recursos/conexoes-de-agentes). 2. **Adicione um projeto** — Escolha uma pasta com um repositório git, clone um a partir de uma URL ou crie um projeto novo. O Tallos usa sua branch padrão como base de todo workspace novo. 3. **Crie a tarefa** — Clique em **Novo workspace**, escolha o projeto e o agente e dê um nome à tarefa (ou deixe em branco). Se quiser, vincule um item do GitHub, GitLab, Linear ou Jira. O worktree e a branch são criados em segundo plano. 4. **Descreva o trabalho** — Claude Code, Codex e Grok CLI abrem numa visão de chat; agentes sem suporte a chat, como Gemini CLI ou OpenCode, abrem no terminal. Diga o que mudar e como você vai conferir. 5. **Rode mais em paralelo** — Crie outro workspace para outra tarefa, ou dê a mesma tarefa a um segundo agente com **Tentar outro agente**. Cada um ganha sua própria cópia do repositório. 6. **Acompanhe e responda** — Os ícones de status mostram quem está trabalhando, quem precisa de você e quem terminou. Os agentes começam no modo manual, então pedem antes de rodar comandos. 7. **Veja o resultado** — Abra o servidor de dev no navegador integrado do workspace. Clique num elemento da página para mandar o HTML, os estilos e um print dele para o agente. 8. **Revise o diff** — O diff compara o workspace com a branch de origem. Deixe notas nas linhas e use **Enviar notas para** para mandar tudo ao agente de uma vez. Repita até ficar certo. 9. **Mantenha ou descarte** — Para manter, faça commit, push e **Criar PR** no controle de código-fonte, depois o merge. Para jogar fora, apague o workspace: o Tallos remove a pasta e a branch. > Veja o ciclo no seu próprio repositório. O Tallos roda no macOS e no Windows com os agentes que você já usa. → https://runtallos.com/signup ## Por que cada tarefa ganha seu próprio git worktree? Cada tarefa ganha seu próprio git worktree para um agente nunca sobrescrever o outro. Um **git worktree** é uma segunda pasta de trabalho do mesmo repositório, com branch e arquivos próprios no disco. Dois agentes podem mudar o mesmo arquivo em dois workspaces sem colisão até você escolher o que mesclar. Um worktree novo é um checkout limpo, então arquivos ignorados pelo git, como o `.env`, não estão lá; liste os que devem ser copiados num arquivo `.worktreeinclude` na raiz do repositório. Um workspace pode partir da branch base, de outra branch, de um commit ou de uma branch remota. Detalhes em [workspaces paralelos](https://runtallos.com/pt/recursos/workspaces-paralelos). > **Isolamento de arquivos, não de permissões** — O worktree separa as tarefas; ele não isola o agente do seu computador. Por isso o Tallos começa com os agentes no modo manual. Deixar os agentes rodarem comandos sem perguntar é opcional, em Configurações → Agentes → Permissões do agente. ## Como rodar e acompanhar vários agentes ao mesmo tempo? Você roda vários agentes ao mesmo tempo abrindo um workspace por tarefa e colocando os painéis lado a lado. Arraste uma aba até a borda de um painel para dividir e misture agentes, servidores de dev, testes, diffs e navegador no mesmo layout. - **Chat ou terminal.** Agentes suportados abrem numa visão de chat legível, com mensagens, chamadas de ferramentas e cards de perguntas. **Ver terminal** mostra o CLI bruto; **Voltar ao chat** volta. Veja [chat nativo](https://runtallos.com/pt/recursos/chat-nativo). - **Status num relance.** Cada sessão mostra trabalhando, precisa de você, concluído ou ocioso na barra lateral, então você só abre a que precisa de resposta. - **Uso e limites.** A barra de status mostra o uso e as janelas de limite de agentes como Claude Code, Codex e Gemini. - **Um navegador por workspace.** O app de cada agente fica ao lado do código dele. Quantos agentes fazem sentido depende da sua máquina, dos planos dos seus agentes e de quanto você consegue revisar. Veja [como rodar agentes de IA em paralelo](https://runtallos.com/pt/rodar-agentes-de-ia-em-paralelo). ## O que acontece onde no Tallos? Cada etapa do fluxo de desenvolvimento com vários agentes tem um lugar no app. | Etapa | Onde no Tallos | O que você faz | | --- | --- | --- | | Conectar | Configurações → Conexões | Instalar agentes, fazer login ou salvar a chave de API, ver modelos | | Escolher o trabalho | Tarefas (GitHub, GitLab, Linear, Jira) | Abrir um workspace a partir de issue, PR ou ticket | | Isolar | Novo workspace: um git worktree e uma branch | Escolher projeto, ponto de partida e agente | | Instruir | Painel do agente: chat ou terminal | Descrever o trabalho, responder perguntas | | Rodar | Divisões de terminal | Servidores de dev, testes e mais agentes lado a lado | | Acompanhar | Status na barra lateral, notificações, barra de status | Responder o que precisa de você | | Ver o app | Navegador integrado, um por workspace | Clicar num elemento e mandar para o agente | | Revisar | Visualizador de diff | Deixar notas por linha e devolver tudo de uma vez | | Entregar | Controle de código-fonte e a aba do PR | Commit, push, abrir o PR, ver o CI, merge | | Coordenar | Squads | Definir objetivo e time, depois aceitar ou descartar | | Repetir | Automações e agendamentos de squads | Rodar um prompt ou uma squad salva num agendamento | _O fluxo com vários agentes, etapa por etapa, dentro do app_ ## Como funciona a orquestração de agentes de IA com squads? Uma **squad** é um agente líder mais agentes membros que o Tallos roda como um trabalho só. Você escreve o objetivo; o líder divide, inicia cada membro no seu próprio worktree, confere o que volta e repete. Uma rodada é planejar, distribuir e revisar. - **Templates:** Construir + revisar; 3 tentativas, escolhe a melhor; Líder divide o trabalho; ou Personalizado. - **Time:** cada membro tem agente, modelo, nível de esforço e função próprios; **Quantos** roda várias cópias do mesmo membro. - **Limites:** 5 rodadas e 4 membros ao mesmo tempo por padrão, até 20 rodadas e 12 membros. O Tallos recusa membros acima do limite; o líder para e reporta ao chegar no limite de rodadas. - **Perguntas:** quando o líder está travado de verdade, ele pergunta com `tallos squad ask` e espera. Você escolhe uma opção ou escreve sua resposta. - **Revisão final:** o líder reporta com `tallos squad report`; você vê os resultados por worktree, um marcado como **Recomendado**. O líder recebe a instrução de nunca fazer merge nem push. Você escolhe **Aceitar** ou **Descartar**, e aceitar também não faz merge: você abre o worktree recomendado para criar o PR ou mesclar. Squads podem ser salvas, reusadas e agendadas. Veja [squads](https://runtallos.com/pt/recursos/squads). ## Como funcionam revisão, aceite e merge? A revisão é o portão entre o trabalho do agente e o seu código. Todo workspace tem um diff contra a branch de onde partiu, em linha ou lado a lado. Deixe notas em qualquer linha e use **Enviar notas para** para entregá-las à sessão ativa do agente ou a um agente novo: um prompt só, com cada nota presa à sua linha. Com o diff limpo, o controle de código-fonte leva você por **Commit**, **Push** e **Criar PR** no GitHub, GitLab ou Bitbucket Cloud, e PRs do GitHub vinculados mostram checks e revisões no app. Mais em [revisão de diff](https://runtallos.com/pt/recursos/revisao-de-diff). > **Nada é mesclado sozinho** — O Tallos nunca faz merge do trabalho de um agente por conta própria. Ele fica na branch do workspace até você mesclar ou apagar o workspace. ## Os agentes podem rodar num agendamento? Sim. Uma **automação** é um prompt que um agente roda num agendamento: a cada hora, todo dia, em dias úteis, toda semana ou numa expressão cron personalizada. Cada execução pode começar num workspace novo ou continuar num existente. Squads salvas podem rodar a cada hora, todo dia, em dias úteis ou toda semana. O resultado espera sua revisão. Veja [automações](https://runtallos.com/pt/recursos/automacoes). ## Qual a diferença para rodar agentes em terminais na mão? Dá para montar o mesmo fluxo na mão com terminais e `git worktree`. Funciona com dois agentes; o trabalho extra cresce a cada agente novo. **Na mão: terminais + worktrees** - `git worktree add` e um nome de branch para cada tarefa - Uma janela de terminal ou painel do tmux por agente - Olhar painel por painel para ver quem espera você - Ler o `git diff` e redigitar o feedback no prompt - Dividir e distribuir o trabalho você mesmo - Push, abrir o PR no navegador, remover worktrees na mão **No Tallos** - **Novo workspace** cria o worktree e a branch em segundo plano - Cada agente no seu painel, em chat ou terminal - Ícones de status e notificações mostram quem precisa de você - Notas por linha no diff voltam para o agente de uma vez - O líder da squad divide o trabalho e confere os resultados - Commit, push, PR e limpeza na mesma janela > **Continua sendo git** — Todo workspace do Tallos é um git worktree de verdade. Abra um terminal nele e use git normalmente; o Tallos percebe as mudanças. > Pare de amarrar terminais na mão. Rode o ciclo inteiro no Tallos. → https://runtallos.com/signup ## Perguntas frequentes ### Como funciona um ADE? Um ADE dá a cada tarefa um workspace isolado, roda um agente de IA dentro dele e passa o diff resultante pela sua revisão antes do merge. O Tallos faz isso com um git worktree por tarefa e os agentes CLI que você já usa. ### O que é orquestração de agentes de IA? Orquestração de agentes de IA é quando um agente planeja o trabalho e coordena os outros. No Tallos, o líder da squad divide o objetivo, inicia os membros em worktrees próprios, confere os resultados e só pergunta a você quando trava. ### Como funciona o desenvolvimento com vários agentes de IA? Vários agentes de IA cuidam de tarefas separadas, ou da mesma tarefa, ao mesmo tempo, cada um no seu workspace, enquanto você planeja e revisa. No Tallos você faz isso com workspaces paralelos ou com uma squad. ### O Tallos faz merge do código sozinho? Não. O trabalho fica na branch do workspace até você fazer commit, push e merge. Aceitar uma squad também não faz merge; você abre o worktree recomendado para criar o PR ou mesclar. ### Os agentes no Tallos rodam comandos sem perguntar? Não por padrão. O Tallos começa com os agentes no modo manual, então eles pedem antes de rodar comandos. O modo autônomo é opcional, em Avançado na tela de boas-vindas ou em Configurações → Agentes → Permissões do agente. ### O que acontece com os workspaces que eu não quero manter? Apague. O Tallos pede confirmação e remove a pasta do worktree e a branch. Ao descartar uma squad, você também pode apagar os worktrees dos membros. ## Fontes 1. [git-worktree documentation](https://git-scm.com/docs/git-worktree) — Git 2. [Run parallel sessions with worktrees](https://code.claude.com/docs/en/worktrees) — Anthropic 3. [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/getting-started/intro) — Model Context Protocol --- **Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem. https://runtallos.com/signup (macOS 13+ · Windows 10+)