Codiff

빠른 로컬 리뷰

어떤 Git 저장소에서도 변경 사항을 검토하고 직접 커밋할 수 있습니다. 좌우 분할 또는 통합 뷰로 코드 차이를 표시하여 직관적인 diff 분석을 지원합니다.

LLM 워크스루 생성

codiff -w 명령을 실행하여 최적화된 커밋 워크스루를 생성할 수 있습니다. Codex, Claude Code, OpenCode, Pi 등 다양한 AI 백엔드를 활용하여 변경 사항에 대한 내러티브 설명을 제공합니다.

인라인 리뷰 코멘트

GitHub 풀 리퀘스트 또는 GitLab 머지 요청에 직접 코멘트를 작성하거나, 마크다운 형식으로 리뷰 코멘트를 복사하여 후속 작업에 활용할 수 있습니다.

정의 탐색

Mod/Ctrl 클릭을 통해 식별자의 로컬 정의를 빠르게 찾아볼 수 있으며, 언어 서버를 시작하지 않고도 코드 탐색이 가능합니다.

다운로드 및 설치 방법

GitHub 릴리스 페이지에서 최신 버전의 Codiff 앱을 다운로드할 수 있습니다. zip 형식으로 제공되며, 다운로드 후 압축을 해제하여 실행할 수 있습니다.

앱 설치 후 Codiff > Install Terminal Helper 메뉴를 실행하여 터미널에서 codiff 명령을 사용할 수 있도록 설정해야 합니다.

기본 사용법

터미널에서 Git 저장소 내에서 간단히 codiff 명령을 실행하면 현재 작업 중인 변경 사항을 검토할 수 있습니다.

특정 경로의 저장소를 검토하려면 다음과 같이 경로를 지정할 수 있습니다:

codiff /path/to/repository

특정 커밋을 검토하려면 커밋 해시를 인수로 전달합니다:

codiff a1b2c3d

현재 브랜치를 대상 브랜치와 비교하려면 브랜치 이름을 지정합니다:

codiff main

GitHub 풀 리퀘스트 또는 GitLab 머지 요청을 검토하려면 다음과 같이 사용할 수 있습니다:

codiff pr 75 (풀 리퀘스트 번호 75 검토)

codiff pr owner:my-feature-branch (포크에서의 풀 리퀘스트 검토)

codiff mr 23 (머지 요청 번호 23 검토)

명령어 및 단축키

Codiff는 다양한 명령줄 옵션과 인터랙티브 단축키를 제공합니다.

주요 명령줄 옵션

• codiff --help: 모든 사용 가능한 옵션 표시
• codiff -w: LLM 생성 워크스루 시작
• codiff -w a1b2c3d: 특정 커밋에 대한 워크스루 생성
• codiff --share: 워크스루 공유 URL 생성
• codiff --share HEAD: 현재 HEAD에 대한 워크스루 공유
• codiff --completions bash: bash 셸 자동완성 스크립트 생성

인터랙티브 단축키

• Cmd/Ctrl+Shift+P: 명령 바 열기 (macOS는 Cmd, 기타 플랫폼은 Ctrl)
• Mod+Enter: 리뷰 코멘트 제출
• Mod+Shift+o: 현재 선택된 파일을 외부 편집기로 열기
• Mod+f: diff 내 검색
• Mod+p: 파일 필터
• Enter: 다음 검색 매치로 이동
• Shift+Enter: 이전 검색 매치로 이동
• Escape: 검색 닫기 또는 명령 바 닫기
• Mod+Shift+b: 사이드바 토글 (왼쪽/오른쪽 전환)

구성 방법

Codiff는 ~/.codiff/codiff.jsonc 파일에서 구성을 읽으며, Codiff > Open Config File… 메뉴를 통해 기본 설정 파일을 생성하고 편집할 수 있습니다.

주요 설정 옵션에는 다음과 같은 것들이 포함됩니다:

• settings.diffStyle: split ( side-by-side ) 또는 unified ( unified diff ) 선택
• settings.showWhitespace: 공백만 있는 변경 사항 표시 여부
• settings.wordWrap: 긴 diff 줄 줄바꿈 여부
• settings.codeFontFamily: 코드 폰트 지정 (예: “JetBrains Mono”)
• settings.sidebarPosition: 사이드바 위치 (left 또는 right)
• settings.agentBackend: 워크스루용 AI 백엔드 선택 (codex, claude, opencode, pi)

편집기 연동을 위해 settings.editorCommand를 설정할 수 있으며, {file}, {line}, {repo} 플레이스홀더를 사용할 수 있습니다. 예를 들어:

"subl "{repo}" "{file}""

이런 경우에 유용합니다

Git으로 코드 관리를 하는 개발자가 로컬 저장소의 변경 사항을 시각적으로 검토하고 정확한 커밋 메시지를 작성해야 할 때 유용합니다. 특히 복잡한 리팩터링이나 다수의 파일이 변경된 상황에서 변경 사항을 체계적으로 분석하고 팀원에게 설명할 필요가 있을 때 도움이 됩니다.

오픈소스 프로젝트에 기여하거나 팀 기반 개발을 진행할 때, pull request나 merge request 전에 로컬에서 변경 사항을 사전 검토하여 리뷰 프로세스를 효율적으로 개선할 수 있습니다.

지원 환경·시스템 요구사항

Codiff는 Windows, macOS, Linux에서 실행 가능한 크로스플랫폼 애플리케이션입니다. Windows 사용자를 포함한 모든 주요 데스크톱 운영체제에서 사용할 수 있으며, x64 아키텍처를 지원합니다.

LLM 워크스루 기능을 활용하려면 해당하는 AI 백엔드(Codex, Claude Code, OpenCode, Pi)를 별도로 설치하고 PATH에 등록해야 합니다. 워크스루 기능 없이도 기본적인 diff 뷰어로서의 기능은 정상적으로 작동합니다.

최신 버전·업데이트

현재 버전은 1.12.1이며, 2026년 9월 9일에 마지막으로 업데이트되었습니다. 정기적인 업데이트를 통해 기능 개선 및 버그 수정이 이루어지고 있습니다.