AI 프롬프트로 복사할 수 있는 댓글을 지원하는 로컬 GitHub 스타일 diff 리뷰 CLI 도구
oil-oil/oil-diff
Git 변경 사항을 파일별 diff 목록 대신 업무 목적별로 묶어 한 화면짜리 HTML 리뷰 페이지로 만들어 주는 에이전트 Skill입니다.
- 스타
- 88
- 포크
- 7
- 열린 이슈
- 0
- 마지막 커밋
- 6일 전
어떤 프로젝트인가요?
oil-diff는 AI 코딩 에이전트를 위한 Skill로, 커밋되지 않은 변경 사항이나 커밋 범위, 브랜치 비교를 읽고 Git diff를 구체적인 변경 사항 3~7개로 묶습니다. .oil-diff/index.html에 단일 HTML 보고서를 생성하므로, 리뷰어는 알파벳순 파일 목록을 스크롤하지 않고도 어떤 업무 영역이 바뀌었는지, 왜 바뀌었는지, 어떤 파일을 우선 살펴봐야 하는지 확인할 수 있습니다.
보고서의 각 섹션은 변경 사항 설명과 시각 자료를 함께 보여 줍니다. UI가 바뀐 경우 변경 전후 스크린샷을 제공하고, 로직이나 규칙이 바뀐 경우 라우팅, 흐름 또는 필드 변경 다이어그램을 생성합니다. 각 변경 사항 아래에는 주요 파일과 추가·삭제된 줄 수가 표시되며, 참조 자료, 설정, 문서 같은 보조 변경 사항은 카드 하단에 접어 둡니다. 접을 수 있는 파일 트리와 오른쪽 서랍에서 각 파일의 변경 전후 코드를 확인할 수 있습니다.
생성된 결과물은 <repo>/.oil-diff/에 저장되고 git-ignored 처리되므로 프로젝트 파일과 git status는 그대로 유지됩니다. 최종 HTML은 오프라인에서 사용할 수 있는 독립형 파일입니다. 시스템에 설치된 git과 Python 3.10+ 표준 라이브러리만 있으면 되며 API 키는 필요하지 않습니다. macOS, Windows, Linux에서 실행할 수 있습니다.
핵심 기능
- 01diff를 파일 목록이 아닌 업무 수준의 변경 사항 3~7개로 묶습니다.
- 02브라우저에서 바로 열 수 있는 오프라인 HTML 보고서 하나를 생성합니다.
- 03각 변경 사항의 변경 전후 스크린샷이나 자동 생성 다이어그램을 보여 줍니다.
- 04주요 리뷰 대상 파일과 보조 변경 사항을 구분하고 줄 수 통계를 제공합니다.
- 05접을 수 있는 파일 트리와 변경 전후 코드를 보여 주는 사이드 서랍을 제공합니다.
- 06저장소를 수정하지 않고 git-ignored 폴더에 결과물을 작성합니다.
활용 사례
- 병합 전후에 팀에 변경 사항을 공유할 때.
- 변경된 영역을 먼저 파악해 대규모 브랜치를 리뷰할 때.
- AI 코딩 에이전트가 작업 트리에서 방금 수정한 내용을 이해할 때.
- 저장소에 접근할 수 없는 동료와 독립형 HTML 변경 요약을 공유할 때.
빠른 시작
- 1
npx로 Skill 설치하기
npx skills add oil-oil/oil-diff - 2
현재 변경 사항에 대한 보고서를 생성해 달라고 Agent에 요청하기
사용 전 알아둘 점
- 시스템에 git이 설치되어 있어야 하며 Python 3.10 이상이 필요합니다.
- Agent Skill이므로 사용하려면 Skills를 불러올 수 있는 AI agent가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- oil-diff은(는) 무엇인가요?
- Git 변경 사항을 파일별 diff 목록 대신 업무 목적별로 묶어 한 화면짜리 HTML 리뷰 페이지로 만들어 주는 에이전트 Skill입니다. oil-diff는 AI 코딩 에이전트를 위한 Skill로, 커밋되지 않은 변경 사항이나 커밋 범위, 브랜치 비교를 읽고 Git diff를 구체적인 변경 사항 3~7개로 묶습니다. .oil-diff/index.html에 단일 HTML 보고서를 생성하므로, 리뷰어는 알파벳순 파일 목록을 스크롤하지 않고도 어떤 업무 영역이 바뀌었는지, 왜 바뀌었는지, 어떤 파일을 우선 살펴봐야 하는지 확인할 수 있습니다.
- oil-diff은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- oil-diff은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- oil-diff은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. oil-diff의 마지막 커밋은 2026년 10월 31일입니다.
- oil-diff은(는) 어디에 사용할 수 있나요?
- 병합 전후에 팀에 변경 사항을 공유할 때. 변경된 영역을 먼저 파악해 대규모 브랜치를 리뷰할 때. AI 코딩 에이전트가 작업 트리에서 방금 수정한 내용을 이해할 때. 저장소에 접근할 수 없는 동료와 독립형 HTML 변경 요약을 공유할 때.
- oil-diff는 어떻게 설치하나요?
- npx로 Skill 설치하기: npx skills add oil-oil/oil-diff 현재 변경 사항에 대한 보고서를 생성해 달라고 Agent에 요청하기
- oil-diff은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/oil-oil/oil-diff
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
git의 기본 pager를 대체하도록 설정할 수 있는, git·diff·grep·blame 출력을 위한 구문 강조 pager입니다.
줄 단위가 아닌 구문 트리로 파일을 비교해, 서식 변경과 코드 이동도 정확히 보여주는 CLI diff 도구입니다.
Git, Jujutsu, Sapling, GitHub PR, 원시 파일의 코드 변경 사항을 검토하고 인라인 에이전트 노트를 추가할 수 있는 인터랙티브 터미널 diff 뷰어입니다.
터미널에서 GitHub 스타일의 구문 강조를 적용해 diff를 좌우로 나란히 보여주는 git 페이저입니다.
tree-sitter로 코드를 구조적으로 비교하고 이미지, 폰트, 아카이브, PDF도 비교하는 Rust 기반 콘텐츠 인식 diff 도구입니다.