O que é a revisão de diff no Tallos?
A revisão de diff é o conjunto de ferramentas do Tallos para ler, corrigir e entregar o que um agente mudou. Como cada tarefa roda no seu próprio workspace paralelo, cada workspace tem o próprio diff: só as mudanças daquele agente, comparadas com a branch de onde ele partiu.
A ideia é revisar como líder, não como babá. Você lê a mudança inteira uma vez, anota o que precisa mudar, devolve e só faz merge do que aprovar. O guia para revisar código gerado por IA mostra o que olhar em cada trecho.
O que o visualizador de diff mostra?
O visualizador de diff foi feito para revisão de verdade, não para uma olhada rápida. Por padrão ele compara o workspace com a branch de origem; pela barra de ferramentas dá para comparar com qualquer commit, branch ou a branch base do repositório.
- Diff combinado de arquivos staged, não staged e não rastreados, com uma árvore de arquivos redimensionável ao lado.
- Visão em linha ou lado a lado, números de linha dos dois lados e quebra de linha opcional.
- Prévia de HTML: abra um arquivo HTML alterado numa divisão de navegador ao lado, usando o navegador integrado.
- Conflitos de merge em visão de três vias, com a opção de resolver com IA quando você quer que um agente faça a primeira passada.
- Navegação pelo teclado:
F7eShift+F7pulam para a próxima e a anterior mudança.
Como mando comentários de revisão de volta ao agente?
Deixe notas nas linhas que precisam mudar e mande todas ao agente de uma vez. Mandar em lote mantém o feedback coerente: uma rodada de raciocínio, uma passada de revisão.
- 1
Abra o diff do workspace
Passe por cada arquivo alterado. Em cada trecho, pergunte se a mudança é necessária, mínima e coerente com o resto do arquivo.
- 2
Adicione uma nota numa linha
Passe o mouse sobre a linha e clique no + da margem, ou selecione um intervalo. Escreva o feedback em frases completas; Markdown funciona.
- 3
Envie as notas
Abra Enviar notas para e escolha a Sessão de agente ativa naquele workspace, ou inicie um Novo agente. O Tallos monta um prompt único com cada nota ancorada na sua linha.
- 4
Deixe o agente revisar
Acompanhe pelo chat ou pelo terminal. As notas continuam presas às linhas, então você confere cada correção.
- 5
Resolva e repita
Resolva as notas corrigidas e deixe novas observações no resto. Notas não resolvidas vão no próximo lote. Com o diff limpo, faça o commit.
Baixe o Tallos e revise seu próximo diff de IA linha a linha.
Como faço commit, push e abro um pull request?
O painel de controle de código-fonte fica ao lado do diff, e o botão principal sempre mostra o próximo passo útil: selecionar arquivos, depois commit, depois push, pull, sync ou criar o PR.
| Passo | O que o Tallos faz |
|---|---|
| Commit | Selecione os arquivos e escreva a mensagem, ou use Gerar com IA para um rascunho a partir das mudanças. Os hooks de pre-commit do repositório rodam normalmente. |
| Commit que falhou | A correção com IA inicia seu agente padrão com a saída do hook, a mensagem tentada e os arquivos selecionados. Ele é instruído a corrigir, não a pular os hooks. |
| Push | Envia a branch e define o upstream na primeira vez. Nunca faz force push escondido; force push com lease é uma ação separada e identificada. |
| Abrir o PR ou MR | Confirme branch base, título, descrição e rascunho, ou gere os detalhes com IA. GitHub, GitLab e Bitbucket Cloud são suportados. |
| Empilhar no GitHub | Quando a base já tem um PR aberto, dá para empilhar o novo PR sobre ele. |
Com quais ferramentas de revisão e tarefas o Tallos se conecta?
O Tallos liga cada workspace ao pull request e ao ticket a que ele pertence, então o estado da revisão e da tarefa fica ao lado do código.
| Ferramenta | O que dá para fazer no Tallos |
|---|---|
| GitHub | Checks, revisões e comentários numa aba de PR; responder em threads de revisão; mandar checks quebrados para um agente corrigir; auto-merge ou merge queue; issues e GitHub Projects em Tarefas. |
| GitLab | Merge requests e issues na mesma tela de revisão; jobs de pipeline, inclusive pipelines filhos, com logs no painel de checks. |
| Linear | Navegar, criar e atualizar issues (status, responsável, prioridade, labels, estimativa); criar um workspace a partir da issue com o nome de branch do Linear; imagens da issue entram no prompt do agente. |
| Jira | Cloud ou self-hosted; editar status, prioridade, responsável e campos personalizados; comentar; criar um workspace a partir da issue. As credenciais são criptografadas com o cofre do sistema. |
Pull requests do Bitbucket Cloud, Azure DevOps e Gitea também aparecem na barra lateral do workspace e no painel de checks.
Como a revisão de diff funciona com squads?
Quando uma squad termina, o trabalho de cada membro fica no próprio worktree. A revisão final lista os resultados por worktree com Ver alterações, que abre o mesmo visualizador de diff. Anote, mande as notas a um agente e use Abrir para criar PR no resultado que você vai manter. Nada é mesclado até você decidir.
Perguntas frequentes
Como reviso o código do Claude Code ou do Codex antes do merge?
Abra o diff do workspace no Tallos, adicione notas nas linhas que precisam mudar e mande todas ao agente de uma vez. Repita até o diff ficar limpo e depois faça commit, push e abra o pull request.
Consigo mandar comentários de linha de volta para um agente de IA?
Sim. Adicione notas em qualquer linha ou intervalo do diff e use Enviar notas para, escolhendo a sessão de agente ativa ou um novo agente. O Tallos manda todas as notas num prompt só, cada uma ancorada na sua linha.
O Tallos faz force push na minha branch?
Não de forma escondida. O push nunca vira force; o force push com lease é uma ação separada que mostra quantos commits substitui e usa --force-with-lease.
Dá para ver os checks e comentários de revisão do GitHub no Tallos?
Sim. PRs do GitHub vinculados abrem numa aba com checks, revisões e comentários, e checks quebrados podem ir direto para um agente corrigir.
O Tallos funciona com Linear e Jira?
Sim. Conecte o Linear com um token de API pessoal e o Jira Cloud ou self-hosted com suas credenciais, depois navegue pelas issues, atualize e crie um workspace a partir de qualquer uma.
Um agente pode escrever minha mensagem de commit?
Sim. Gerar com IA cria um rascunho da mensagem a partir das mudanças selecionadas, e o diálogo do pull request gera título e descrição. Você revisa os dois antes de enviar.
