Repolode
Submit
oil-oil

oil-oil/oil-diff

An agent Skill that turns Git changes into a one-screen HTML review page grouped by business purpose, instead of a file-by-file diff list.

View on GitHub
Stars
91
Forks
7
Open issues
0
Last commit
7 days ago

What is it?

oil-diff is a Skill for AI coding agents that reads uncommitted changes, a commit range, or a branch comparison and groups the Git diff into three to seven concrete changes. It generates a single HTML report at .oil-diff/index.html, so a reviewer can see which business areas changed, why, and which files matter most without scrolling through an alphabetical file list.

Each section of the report pairs its explanation with a visual: before-and-after screenshots when the UI changed, or generated routing, flow, or field-change diagrams for logic and rule changes. Core files are listed under each change with added and removed line counts, while supporting edits such as references, config, and docs are folded at the bottom of each card. A collapsible file tree and a right-side drawer show the before and after code for any file.

Generated output lives in <repo>/.oil-diff/ and is git-ignored, so the project's own files and git status are left untouched. The final HTML is a self-contained offline file. It needs only system git and Python 3.10+ standard library, with no API keys, and runs on macOS, Windows, and Linux.

Key features

  • 01Groups a diff into three to seven business-level changes rather than a file list.
  • 02Generates a single offline HTML report that opens directly in a browser.
  • 03Shows before-and-after screenshots or auto-generated diagrams for each change.
  • 04Separates core files to review from supporting edits with line-count stats.
  • 05Provides a collapsible file tree and a side drawer with before and after code.
  • 06Writes output to a git-ignored folder without modifying the repository.

Use cases

  • Presenting a round of changes to a team before or after merging.
  • Reviewing a large branch by first getting an overview of which areas changed.
  • Understanding what an AI coding agent just modified in the working tree.
  • Sharing a self-contained HTML change summary with colleagues who lack repo access.

Quick start

  1. 1

    Install the Skill with npx

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

    Ask your Agent to generate the report for your current changes

Things to know

  • Requires a system git install and Python 3.10+.
  • It is an agent Skill, so you need an AI agent that can load Skills to use it.

In collections

AI code review toolsAI coding assistants & agentsAI agent skill librariesDiagrams, charts & animated visualizations

Topics

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

FAQ

What is oil-diff?
An agent Skill that turns Git changes into a one-screen HTML review page grouped by business purpose, instead of a file-by-file diff list. oil-diff is a Skill for AI coding agents that reads uncommitted changes, a commit range, or a branch comparison and groups the Git diff into three to seven concrete changes. It generates a single HTML report at .oil-diff/index.html, so a reviewer can see which business areas changed, why, and which files matter most without scrolling through an alphabetical file list.
Is oil-diff free to use? What license does it have?
oil-diff is open source under the MIT license. Check the license terms before using it in commercial products.
Is oil-diff still maintained?
Actively maintained. The last commit to oil-diff was on Oct 31, 2026.
What can I use oil-diff for?
Presenting a round of changes to a team before or after merging. Reviewing a large branch by first getting an overview of which areas changed. Understanding what an AI coding agent just modified in the working tree. Sharing a self-contained HTML change summary with colleagues who lack repo access.
How do I install oil-diff?
Install the Skill with npx: npx skills add oil-oil/oil-diff Ask your Agent to generate the report for your current changes
Where can I get oil-diff?
The source code and installation instructions are on GitHub: https://github.com/oil-oil/oil-diff

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects