Revdiff: Visualizador de Diferenciais no Terminal com Anotações Embutidas para Agentes de IA

O que o Revdiff Faz

Revdiff é um visualizador de diff com interface de usuário de terminal (TUI) projetado para um fluxo de trabalho específico: revisar alterações de código geradas por IA sem sair da sessão de terminal onde o agente de IA está sendo executado. A ferramenta permite que você anote linhas, blocos ou arquivos e alimente essas anotações diretamente de volta para o agente de IA para processamento.

Fluxo de Trabalho Principal

De uma sessão do Claude Code, você pode digitar /revdiff main ou dizer "revisar diff dos últimos 3 commits" para abrir o revdiff como uma sobreposição de terminal em cima da sessão do agente. Após ler o diff e adicionar anotações, você sai, e as anotações vão diretamente de volta para o agente. Quando o agente termina de fazer as alterações, o revdiff reabre automaticamente nas novas alterações, criando um loop contínuo até que você saia sem deixar anotações.

Integração de Planejamento

Um plugin separado revdiff-planning se conecta ao modo de planejamento do Claude Code. Quando o agente termina um plano e chama ExitPlanMode, o revdiff abre automaticamente no texto do plano. Você pode anotar partes com as quais discorda ou que deseja expandir, sair, e o agente revisa o plano antes de escrever qualquer código.

Principais Recursos

• TUI de dois painéis: árvore de arquivos à esquerda, diff com destaque de sintaxe à direita
• Navegação estilo Vim com /busca, salto entre blocos e destaque de alterações em nível de palavra
• Gutters de blame mostrando nome do autor e idade do commit por linha
• Modo de diff recolhido mostrando texto final com marcadores de alteração
• Modo de quebra de linha com marcadores de continuação
• Indicadores de estouro de rolagem horizontal com marcadores « / »
• Números de linha com gutters lado a lado antigo/novo para diffs
• Suporte ao Mercurial com detecção automática e tradução de referências no estilo git
• Detecção automática de arquivo único que oculta o painel de árvore para visualização de diff em largura total
• Popup de lista de anotações para navegar por todas as anotações entre arquivos
• Linha de status com nome do arquivo, estatísticas de diff, posição do bloco e indicadores de modo
• Sobreposição de ajuda mostrando todos os atalhos de teclado organizados por seção
• Navegação por TOC Markdown para arquivos markdown de arquivo único
• Modo todos os arquivos para navegar e anotar todos os arquivos rastreados pelo git
• Revisão de arquivos sem git para arquivos fora de repositórios
• Revisão de buffer de rascunho para texto arbitrário canalizado ou redirecionado
• Histórico de revisão salvo automaticamente em ~/.config/revdiff/history/

Personalização

O Revdiff oferece 7 temas de cores incluídos, atalhos de teclado remapeáveis e substituições por cor via flags de linha de comando, variáveis de ambiente ou arquivo de configuração. Você pode exportar os atalhos de teclado padrão com --dump-keys.

Instalação e Uso

Instale via Homebrew: brew install umputun/apps/revdiff. A ferramenta é um único binário - basta executar revdiff HEAD~3 para revisar seus últimos 3 commits. Funciona com repositórios git e Mercurial.

Suporte a Plugins

Plugins prontos para uso estão disponíveis para Claude Code (sobreposição de terminal via tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2 ou Emacs vterm), Codex e pi. O plugin do Claude Code requer um dos terminais suportados, pois o próprio Claude Code não pode exibir aplicativos TUI interativos.

Detalhes Técnicos

Escrito em Go e de código aberto sob licença MIT. Requer git ou hg para gerar diffs (opcional ao usar --only ou --stdin).