# Revisão de diff: leia cada mudança da IA, devolva notas e entregue o que aprovar

> A revisão de diff do Tallos é o ciclo para conferir o código que agentes de IA escrevem. Cada workspace tem um diff contra a branch de onde partiu. Você deixa notas em qualquer linha, manda todas ao agente de uma vez e repete até o diff ficar limpo. Depois faz commit, push e abre o pull request, com GitHub, GitLab, Linear e Jira ligados ao mesmo workspace.

- Canonical: https://runtallos.com/pt/recursos/revisao-de-diff
- English: https://runtallos.com/features/diff-review.md
- Atualizado em: 2026-09-29
- Section: Recursos

## Em resumo

- Um diff por workspace, contra a branch de origem
- Notas por linha enviadas ao agente de uma vez
- Commit, push e PR ou MR dentro do app
- Checks, revisões e comentários do GitHub no app
- Issues do Linear e do Jira ligadas ao workspace

## 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](https://runtallos.com/pt/recursos/workspaces-paralelos), 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](https://runtallos.com/pt/aprenda/revisar-codigo-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](https://runtallos.com/pt/recursos/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**: `F7` e `Shift+F7` pulam 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](https://runtallos.com/pt/recursos/chat-nativo). 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. → https://runtallos.com/signup

## 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. |

_Entregando um workspace pelo painel de controle de código-fonte_

## 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. |

_Integrações de revisão e tarefas no Tallos_

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](https://runtallos.com/pt/recursos/squads) 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.

> **Por que isso importa** — Editores foram feitos para uma pessoa digitando. Quando vários agentes escrevem código ao mesmo tempo, o gargalo passa a ser a revisão. Veja [ADE vs IDE](https://runtallos.com/pt/comparar/ade-vs-ide) para entender como um ambiente de desenvolvimento de agentes é pensado para isso.

## 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.

---

**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+)