Pular para o conteúdo
claudemods

Diff: o painel diff do Claude Code com as mudanças não commitadas da sua sessão

Um painel /diff para o Claude Code: mudanças não commitadas, arquivo por arquivo com seus hunks, sempre atualizado.

Permissões

  • Lê arquivosPode ler arquivos e listar diretórios na sua máquina ($.fs.read / list / stat / exists).
  • Executa comandosPode executar programas de shell na sua máquina ($.process.run / spawn). Confira no código-fonte exatamente quais.
  • Intercepta chamadas de ferramentasVê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
  • Lê seus promptsPode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
  • Altera a interfaceDesenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
  • Adiciona comandos/ferramentasRegistra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
  • Armazena dadosGuarda dados entre sessões no armazenamento privado do plugin ($.store.*).
testado com
v2.1.310
último teste
requer
Claude Code ≥ 2.1.287
superfícies
painel

Instale dentro do Claude Code:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff
Todas as opções de instalação ↓

O que este mod faz?

O Diff é um mod que a Anthropic publica no repositório claude-code e que listamos aqui como mod da comunidade. Ele é um painel diff do Claude Code: /diff abre as mudanças não commitadas da sessão ao lado da transcrição, com uma linha por arquivo alterado e os hunks de cada arquivo abaixo; outro /diff o fecha. Cada alternância deixa Diff panel shown ou Diff panel hidden na transcrição.

O painel é atualizado depois que o Claude edita um arquivo ou executa um comando de shell, e, enquanto está aberto, acompanha o HEAD do repositório, de modo que um commit ou checkout feito em outro lugar também aparece. Ele pode comparar a árvore de trabalho com o HEAD do início da sessão (o padrão), com o HEAD puro, ou com o merge-base da branch padrão, e um seletor pode mostrar no lugar as edições de um turno anterior. Arquivos que já tinham mudado antes da sessão, além de lockfiles, arquivos gerados e testes, são listados à parte e recolhidos.

Se o terminal for largo o bastante, a primeira edição bem-sucedida de uma sessão abre o painel sozinha. Sem o layout de tela cheia, o /diff abre, em vez disso, um diálogo em linha: uma lista de arquivos com cinco linhas em torno da selecionada, Enter mostra só os hunks daquele arquivo e Escape volta. O botão [ ask ] de um arquivo o arma, de modo que seus hunks seguem uma vez com o próximo prompt como contexto.

Demonstração

A gravação inicia o Claude Code com o mod carregado no pequeno projeto de demonstração, que tem uma mudança não commitada. Ela digita /diff e o autocompletar mostra “Toggle the diff panel showing uncommitted changes”. Depois do Enter, abre-se acima do prompt um diálogo com borda intitulado Uncommitted changes (git diff HEAD), com 1 file changed +2 abaixo. Ele lista src/index.js com um botão [ ask ] e, abaixo, o hunk com números de linha e as duas linhas adicionadas destacadas em verde. O rodapé diz ↑/↓ to scroll · Esc to back. O clipe fica alguns segundos no diálogo. Ele mostra a forma em linha, porque o terminal da demonstração não usa o layout acoplado.

Instalação

Use qualquer um dos métodos do bloco de instalação; eles instalam direto do repositório do próprio autor. Depois do próximo início de sessão, digite /diff dentro de um repositório git com um arquivo modificado.

$ install diff

Requer Claude Code ≥ 2.1.287

Instala a partir do marketplace do autor: anthropics/claude-code

  1. 1.Experimente sem instalar

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/diff

    Carrega o mod só para uma sessão. Nada é adicionado às suas configurações.

Como funciona

O módulo hooks/register.ts registra /diff em session.start, desenha o componente Pane e escuta tool.call de Edit, Write, NotebookEdit, Bash e PowerShell para saber quando atualizar. Cada processo filho do git recebe o diretório git e a árvore de trabalho fixados do repositório, e todo diff começa com os mesmos argumentos fixos, de hooks/git/argv/diff-leading-args.ts:

export const DIFF_LEADING_ARGS = [
  '--no-optional-locks',
  '-c',
  'diff.relative=false',
  '-c',
  'core.quotePath=false',
  'diff',
  '--no-ext-diff',
  '--no-textconv',
  '--ignore-submodules=dirty',
  '--submodule=short',
] as const

O git roda apenas nos momentos em que o painel embutido o executaria: não no início da sessão, uma vez para encontrar o repositório quando o /diff ou a primeira edição precisa dele, e depois nas leituras após uma edição ou um comando de shell. A saída tem um limite, e a partir de 500 arquivos só os totais são mostrados. Se a sessão já tiver outro comando /diff registrado, o mod se afasta.

Personalize

O mod não tem opções em /config. A base de comparação é escolhida no painel e ctrl+x b passa para a próxima; a escolha é guardada por repositório no armazenamento do próprio plugin. A lista rola com ctrl+up/ctrl+down e opt+up/opt+down. Se você não quer que o painel abra na primeira edição, feche-o uma vez e o mod lembra. Definir CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING também interrompe a abertura automática.

Permissões e segurança

Lemos o manifesto, hooks/hooks.json e hooks/register.ts, e pesquisamos nos cerca de 800 arquivos restantes de hooks/ acessos a rede, processos, gravação de arquivos e ambiente. Não lemos linha por linha o diretório de 3,4 MB, que é em grande parte pequenos módulos TypeScript e testes. Não há package.json, script de instalação, binário nem código minificado ou codificado.

  • Altera a interface: o painel ou o diálogo, e os toasts.
  • Adiciona um comando: /diff.
  • Processos: $.process.run apenas para subcomandos de git de leitura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref), com a localidade fixada em C.
  • Rede: nenhuma encontrada. Arquivos: lê arquivos e carimbos de data do repositório com $.fs; só grava em $.store.
  • Ambiente: lê CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING.
  • Telemetria: chama $.telemetry.log e $.telemetry.mark, que são descartados onde falta a telemetria embutida do Claude Code; não encontramos o mod enviando nada por conta própria.
  • Influência sobre o modelo: o hook prompt.submit adiciona os hunks de um arquivo armado ao contexto do prompt, somente depois que você aperta o botão ask desse arquivo.
  • Licença: o LICENSE.md diz “all rights reserved”, sem ID SPDX; por isso esta página só linka e não espelha o código.

O claude plugin validate não relatou erros nem avisos, mas deixou recomendações de que o README não tem linha de instalação e falta um ícone, além de notas de que sete hooks não têm .catch. Os testes do autor passaram: 234 aprovados, 0 falhas em 30 arquivos, com o Claude Code 2.1.310.

Lê arquivos
Pode ler arquivos e listar diretórios na sua máquina ($.fs.read / list / stat / exists).
Executa comandos
Pode executar programas de shell na sua máquina ($.process.run / spawn). Confira no código-fonte exatamente quais.
Intercepta chamadas de ferramentas
Vê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
Lê seus prompts
Pode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
Altera a interface
Desenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
Adiciona comandos/ferramentas
Registra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
Armazena dados
Guarda dados entre sessões no armazenamento privado do plugin ($.store.*).

Compatibilidade e solução de problemas

Verificado com o Claude Code 2.1.310 no macOS (validate, testes e gravação). Se o /diff não mostrar nada:

  • Você está dentro de um repositório git; fora de um, o /diff avisa e não faz mais nada.
  • Há de fato um arquivo modificado; senão você vê No changes this session.
  • Há outro /diff registrado: então o mod fica ocioso.
  • Para a abertura automática, o terminal tem pelo menos 144 colunas com o layout de tela cheia.
  • Abaixo de 110 colunas nesse layout aparece uma linha pedindo um terminal mais largo.

Perguntas frequentes

O Diff envia meu código para algum lugar?
Não encontramos código de rede. Ele executa na sua máquina apenas comandos de git de leitura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref) e desenha o resultado. Só chegam ao modelo os hunks de um arquivo, e somente depois que você aperta o botão ask dele.
Ele altera meu repositório?
Não. Todos os comandos de git que encontramos são de leitura e rodam com --no-optional-locks, --no-ext-diff e --no-textconv. O plugin só grava no próprio armazenamento, onde lembra se o painel estava aberto e qual base de comparação você escolheu.
Por que o /diff às vezes abre sozinho?
Após a primeira edição bem-sucedida de uma sessão, se o checkpointing de arquivos estiver ativo e o terminal for largo o bastante (144 colunas, ou 110 se você já o manteve aberto antes). Se você o fechou, ele não insiste. Em terminais mais estreitos e no layout em linha, só o /diff o abre.
O que o botão ask faz?
Ele arma um arquivo. No seu próximo prompt, o plugin adiciona os hunks desse arquivo como contexto uma vez e o desarma. Se os hunks não couberem no espaço de contexto, são descartados e a linha de status avisa.
Posso redistribuir ou fazer um fork?
Pelo que encontramos, não. O LICENSE.md do repositório diz “All rights reserved” e remete aos Commercial Terms of Service da Anthropic, então linkamos o repositório e não espelhamos o código.
Branch do Git acima do prompt em execução no Claude CodeDestaque

Branch do Git acima do prompt

Mostra a branch do Git, a contagem de alterações e o status ahead/behind em uma faixa acima do prompt do Claude Code.

  • acima do prompt
  • Executa comandos
  • Intercepta chamadas de ferramentas
  • Altera a interface

testado com v2.1.310

cc-pr-tracker em execução no Claude CodeDestaque

cc-pr-tracker

Uma linha por PR do GitHub acima do prompt do Claude Code: merge, revisão, checks obrigatórios e alertas de mudança.

  • acima do prompt
  • notificação
  • Lê arquivos
  • Executa comandos
  • Intercepta chamadas de ferramentas
  • Lê seus prompts
  • Altera a interface
  • Adiciona comandos/ferramentas
  • Armazena dados

testado com v2.1.296

Blast Radius em execução no Claude CodeDestaque

Blast Radius

Segura rm -r, force push e migrações de banco de dados no Claude Code e mostra o que mudariam antes de rodarem.

  • painel
  • acima do prompt
  • Executa comandos
  • Intercepta chamadas de ferramentas
  • Altera a interface

testado com v2.1.291

Mais em Git e GitHub, Ferramentas que você adiciona ao Claude.