CLI-инструмент, который запускает локальный веб-интерфейс в стиле GitHub для просмотра и обсуждения git diff с комментариями, которые можно копировать как промпты для ИИ.
oil-oil/oil-diff
Skill для AI-агентов превращает изменения Git в одностраничный HTML-отчёт, сгруппированный по бизнес-задачам, а не по файлам.
- Звёзды
- 88
- Форки
- 7
- Открытые issues
- 0
- Последний коммит
- 7 дней назад
Что это?
oil-diff — это Skill для AI-агентов, которые пишут код. Он анализирует незакоммиченные изменения, диапазон коммитов или сравнение веток и группирует Git diff в три-семь конкретных изменений. Результат — единый HTML-отчёт в .oil-diff/index.html: рецензент сразу видит, какие бизнес-области затронуты, почему они изменились и какие файлы важнее всего, не прокручивая алфавитный список.
В каждом разделе отчёта объяснение сопровождается визуализацией: скриншотами до и после при изменениях интерфейса или автоматически созданными диаграммами маршрутизации, потоков и изменений полей при изменениях логики и правил. Для каждого изменения перечислены основные файлы с количеством добавленных и удалённых строк, а сопутствующие правки — например, ссылки, конфигурация и документация — собраны внизу карточки. Сворачиваемое дерево файлов и боковая панель позволяют посмотреть код любого файла до и после изменений.
Сгенерированные файлы находятся в <repo>/.oil-diff/ и исключены из Git, поэтому файлы проекта и состояние git status не меняются. Итоговый HTML — автономный файл, который можно открыть без подключения к интернету. Нужны только системный git и стандартная библиотека Python 3.10+, API-ключи не требуются. Инструмент работает на macOS, Windows и Linux.
Ключевые возможности
- 01Группирует diff в три-семь изменений на уровне бизнес-задач, а не в список файлов.
- 02Создаёт единый автономный HTML-отчёт, который можно сразу открыть в браузере.
- 03Для каждого изменения показывает скриншоты до и после или автоматически созданные диаграммы.
- 04Отделяет основные файлы для ревью от сопутствующих правок и указывает статистику по строкам.
- 05Предоставляет сворачиваемое дерево файлов и боковую панель с кодом до и после изменений.
- 06Сохраняет результат в исключённую из Git папку, не изменяя репозиторий.
Сценарии использования
- Показать команде набор изменений до или после слияния.
- Разобраться в большой ветке, сначала получив обзор затронутых областей.
- Понять, что именно AI-агент для написания кода только что изменил в рабочем дереве.
- Поделиться автономным HTML-отчётом об изменениях с коллегами, у которых нет доступа к репозиторию.
Быстрый старт
- 1
Установите Skill с помощью npx
npx skills add oil-oil/oil-diff - 2
Попросите Agent создать отчёт о текущих изменениях
Что важно знать
- Требуется системная установка git и Python версии 3.10 или выше.
- Это Agent Skill, поэтому для его использования нужен AI agent, который умеет загружать Skills.
В подборках
Темы
Частые вопросы
- Что такое oil-diff?
- Skill для AI-агентов превращает изменения Git в одностраничный HTML-отчёт, сгруппированный по бизнес-задачам, а не по файлам. oil-diff — это Skill для AI-агентов, которые пишут код. Он анализирует незакоммиченные изменения, диапазон коммитов или сравнение веток и группирует Git diff в три-семь конкретных изменений. Результат — единый HTML-отчёт в .oil-diff/index.html: рецензент сразу видит, какие бизнес-области затронуты, почему они изменились и какие файлы важнее всего, не прокручивая алфавитный список.
- oil-diff можно использовать бесплатно? Какая у него лицензия?
- oil-diff распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- oil-diff всё ещё поддерживается?
- Активно поддерживается. Последний коммит в oil-diff — 31 окт. 2026 г..
- Для чего можно использовать oil-diff?
- Показать команде набор изменений до или после слияния. Разобраться в большой ветке, сначала получив обзор затронутых областей. Понять, что именно AI-агент для написания кода только что изменил в рабочем дереве. Поделиться автономным HTML-отчётом об изменениях с коллегами, у которых нет доступа к репозиторию.
- Как установить oil-diff?
- Установите Skill с помощью npx: npx skills add oil-oil/oil-diff Попросите Agent создать отчёт о текущих изменениях
- Где скачать oil-diff?
- Исходный код и инструкции по установке — на GitHub: https://github.com/oil-oil/oil-diff
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Пейджер с подсветкой синтаксиса для вывода git, diff, grep и blame, который можно использовать вместо стандартного пейджера git.
Консольная утилита для сравнения файлов по дереву синтаксиса, а не по строкам: она точно показывает переформатирование и перемещение кода.
Интерактивный терминальный просмотрщик diff для проверки изменений из Git, Jujutsu, Sapling, GitHub PR и обычных файлов с заметками агентов рядом с кодом.
Пейджер для Git, который показывает diff в терминале рядом друг с другом с подсветкой синтаксиса в стиле GitHub.
Учитывающий содержимое diff-инструмент на Rust: сравнивает код по структуре с помощью tree-sitter, а также изображения, шрифты, архивы и PDF.