Repolode
Enviar
oil-oil

oil-oil/oil-diff

Uma Skill para agentes que transforma mudanças no Git em uma página HTML de revisão, organizada por finalidade de negócio em vez de listar arquivos um por um.

Ver no GitHub
Estrelas
88
Forks
7
Issues abertas
0
Último commit
há 6 dias

O que é?

oil-diff é uma Skill para agentes de programação com IA. Ela lê mudanças não commitadas, um intervalo de commits ou a comparação entre branches e agrupa o diff do Git em três a sete alterações concretas. A ferramenta gera um único relatório HTML em .oil-diff/index.html para que quem revisa veja quais áreas do negócio mudaram, por quê e quais arquivos são mais relevantes, sem precisar percorrer uma lista de arquivos em ordem alfabética.

Cada seção do relatório combina uma explicação com um recurso visual: capturas de tela de antes e depois quando a interface muda, ou diagramas gerados de rotas, fluxos ou alterações em campos para mudanças de lógica e regras. Os arquivos principais aparecem em cada alteração, com a contagem de linhas adicionadas e removidas; edições complementares, como referências, configurações e documentação, ficam agrupadas na parte inferior de cada cartão. Uma árvore de arquivos recolhível e um painel lateral mostram o código anterior e o atual de qualquer arquivo.

Os arquivos gerados ficam em <repo>/.oil-diff/ e são ignorados pelo Git, sem alterar os arquivos do projeto nem o estado do git. O HTML final é um arquivo independente que funciona offline. Ele requer apenas o git do sistema e a biblioteca padrão do Python 3.10+, sem chaves de API, e funciona no macOS, Windows e Linux.

Recursos principais

  • 01Agrupa um diff em três a sete alterações no nível do negócio, em vez de listar os arquivos.
  • 02Gera um único relatório HTML offline, que pode ser aberto diretamente no navegador.
  • 03Exibe capturas de tela de antes e depois ou diagramas gerados automaticamente para cada alteração.
  • 04Separa os arquivos principais a revisar das edições complementares e mostra estatísticas de linhas.
  • 05Oferece uma árvore de arquivos recolhível e um painel lateral com o código anterior e o atual.
  • 06Grava os arquivos gerados em uma pasta ignorada pelo Git, sem modificar o repositório.

Casos de uso

  • Apresentar uma rodada de alterações à equipe antes ou depois de fazer o merge.
  • Revisar uma branch extensa começando por uma visão geral das áreas que mudaram.
  • Entender o que um agente de programação com IA acabou de modificar na árvore de trabalho.
  • Compartilhar com colegas sem acesso ao repositório um resumo das alterações em HTML independente.

Início rápido

  1. 1

    Instale o Skill com npx

    npx skills add oil-oil/oil-diff
  2. 2

    Peça ao seu Agent para gerar o relatório das alterações atuais

Antes de usar

  • Requer git instalado no sistema e Python 3.10 ou superior.
  • É um Agent Skill, então você precisa de um AI agent que consiga carregar Skills para usá-lo.

Em coleções

Ferramentas de revisão de código com IAAssistentes e agentes de programação com IABibliotecas de skills para agentes de IADiagramas, gráficos e visualizações animadas

Tópicos

#git#diff#code-review#agent-skill#html-report#visualization#developer-tools

Perguntas frequentes

O que é oil-diff?
Uma Skill para agentes que transforma mudanças no Git em uma página HTML de revisão, organizada por finalidade de negócio em vez de listar arquivos um por um. oil-diff é uma Skill para agentes de programação com IA. Ela lê mudanças não commitadas, um intervalo de commits ou a comparação entre branches e agrupa o diff do Git em três a sete alterações concretas. A ferramenta gera um único relatório HTML em .oil-diff/index.html para que quem revisa veja quais áreas do negócio mudaram, por quê e quais arquivos são mais relevantes, sem precisar percorrer uma lista de arquivos em ordem alfabética.
oil-diff é gratuito? Qual é a licença?
oil-diff é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
oil-diff ainda é mantido?
Manutenção ativa. O último commit de oil-diff foi em 31 de out. de 2026.
Para que posso usar oil-diff?
Apresentar uma rodada de alterações à equipe antes ou depois de fazer o merge. Revisar uma branch extensa começando por uma visão geral das áreas que mudaram. Entender o que um agente de programação com IA acabou de modificar na árvore de trabalho. Compartilhar com colegas sem acesso ao repositório um resumo das alterações em HTML independente.
Como instalar oil-diff?
Instale o Skill com npx: npx skills add oil-oil/oil-diff Peça ao seu Agent para gerar o relatório das alterações atuais
Onde consigo oil-diff?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/oil-oil/oil-diff

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados