Hunk - AI 에이전트 코드 리뷰를 위한 터미널 Diff 뷰어 완벽 가이드

Hunk - AI 에이전트 코드 리뷰를 위한 터미널 Diff 뷰어 완벽 가이드

AI 에이전트가 생성한 코드를 리뷰하는 것은 기존 diff 도구로는 부족하다. Hunk는 에이전트-authored 변경 사항을 위해 설계된 리뷰 퍼스트 터미널 diff 뷰어로, 인라인 AI 주석, 멀티파일 리뷰 스트림, 반응형 레이아웃을 터미널에서 제공한다.

Hunk란 무엇인가

Hunk는 GitHub에서 2,700개 이상의 스타를 받은 리뷰 퍼스트 터미널 diff 뷰어다. 기존 CLI diff 도구인 diff, difftastic, delta와 달리, Hunk는 AI 에이전트가 작성한 코드 변경 사항을 시각적으로 검토하는 데 특화되어 있다.

핵심 특징

• 멀티파일 리뷰 스트림: 사이드바 내비게이션으로 여러 파일 변경 사항을 연속적으로 검토

• 인라인 AI/에이전트 주석: 변경 사항 옆에 AI의 reasoning을 직접 표시

• 반응형 자동 레이아웃: 파일 크기에 따라 split/stack 뷰가 자동으로 전환

• 와치 모드: 작업 트리가 변경되면 자동으로 리로드

• 마우스 지원: 터미널 내에서 마우스 클릭/스크롤 지원

• Git 통합: git diff, git show를 Hunk로 열기 가능

주요 명령어

# 설치npm i -g hunkdiff# 현재 저장소의 변경 사항 리뷰hunk diff# 자동 리로드와 함께 리뷰hunk diff --watch# 특정 커밋 리뷰hunk show HEAD~1# 두 파일 직접 비교hunk diff before.ts after.ts# 패치 파일에서 리뷰git diff --no-color | hunk patch -

AI 에이전트 워크플로우

Hunk의 진정한 강점은 AI 에이전트와의 연계에 있다. 에이전트가 코드를 변경하면, 별도 터미널에서 Hunk를 열고 리뷰 스킬을 로드하여 대화형 리뷰를 진행할 수 있다.

에이전트 연계 설정

# 1. 다른 터미널에서 Hunk 열기hunk diff# 2. 에이전트에 스킬 로드 요청# "Load the Hunk skill and use it for this review."

에이전트는 skills/hunk-review/SKILL.md를 사용하여 Hunk 세션과 직접 상호작용하며, 변경 사항에 대한 논리적 설명을 인라인으로 확인할 수 있다.

기존 도구와 비교

기능	Hunk	Lumen	difftastic	Delta	diff-so-fancy
리뷰 퍼스트 UI	✅	✅	❌	❌	❌
멀티파일 스트림 + 사이드바	✅	✅	❌	❌	❌
인라인 AI 주석	✅	❌	❌	❌	❌
반응형 split/stack 레이아웃	✅	❌	❌	❌	❌
터미널 내 마우스 지원	✅	✅	❌	❌	❌
런타임 뷰 토글	✅	✅	❌	❌	❌
구문 강조	✅	✅	✅	✅	❌
구조적 diffing	❌	❌	✅	❌	❌

설치 및 설정

요구 환경

• Node.js 18+

• macOS 또는 Linux

• Git (권장)

빠른 시작

# npm으로 전역 설치npm i -g hunkdiff# 버전 확인hunk --version# 도움말 보기hunk

Git 페이저로 통합

Git의 기본 페이저를 Hunk로 설정하면 git diff, git show 명령이 자동으로 Hunk를 호출한다.

# Git 페이저로 설정git config --global core.pager "hunk pager"

개별 명령만 사용하고 싶다면 별명을 사용할 수 있다.

git config --global alias.hdiff "-c core.pager=\"hunk pager\" diff"git config --global alias.hshow "-c core.pager=\"hunk pager\" show"

설정 파일

환경설정은 ~/.config/hunk/config.toml 또는 프로젝트의 .hunk/config.toml에 저장할 수 있다.

theme = "graphite"          # graphite, midnight, paper, embermode = "auto"                # auto, split, stackexclude_untracked = false    # 작업 트리에서 추적 안 된 파일 제외line_numbers = truewrap_lines = falseagent_notes = false

개발 환경 구축 (소스에서 빌드)

Hunk는 TypeScript 99.5%로 작성되었으며 Bun 런타임에서 실행된다.

# 저장소 클론git clone https://github.com/modem-dev/hunk.gitcd hunk# 의존성 설치 (Bun 사용)bun install# 소스에서 직접 실행bun run src/core/cli.ts diff# 타입 체크bun run typecheck# 테스트 실행bun test

실전 활용 팁

1. 와치 모드로 지속적인 리뷰

AI 에이전트가 지속적으로 코드를 수정할 때, --watch 플래그로 변경 사항을 자동으로 감지하고 리뷰 화면을 갱신할 수 있다.

hunk diff --watch

2. 에이전트 컨텍스트 파일 활용

변경 사항과 함께 AI의 reasoning이 담긴 JSON 파일을 전달하면, 코드 옆에 설명이 나타난다.

hunk patch change.patch --agent-context agent-context.json

3. OpenTUI 컴포넌트로 커스텀 앱 개발

Hunk는 HunkDiffView 컴포넌트를 별도로 제공하여, 자신의 OpenTUI 앱에 동일한 diff 렌더러를 임베딩할 수 있다.

bun run examples/7-opentui-component/from-files.tsx

향후 전망

AI 코드 에이전트가 일상화되면서, 에이전트가 생성한 코드를 체계적으로 리뷰하는 도구의 중요성이 커지고 있다. Hunk는 터미널이라는 개발자 친화적인 환경에서 에이전트의 reasoning을 투명하게 가시화한다는 점에서, 향후 AI 협업 개발 도구로서의 잠재력이 크다.

특히 v0.10.0 (2026년 4월 최신)에서 skill 경로가 기본 내장되고, 에이전트 워크플로우 문서화가 본격화되면서, AI 에이전트 생태계와의 통합이 더욱 진행될 전망이다.

요약

Hunk는 AI 에이전트 시대에 맞춰 설계된 터미널 기반 diff 리뷰 도구다. 주요 장점을 정리하면 다음과 같다.

• 에이전트 연계: 인라인 AI 주석과 스킬 기반 대화형 리뷰

• 시각적 설계: 멀티파일 스트림, 사이드바, 반응형 레이아웃

• 개발자 경험: 마우스 지원, 와치 모드, Git 통합

• 확장성: OpenTUI 컴포넌트로 커스텀 앱 개발 가능

AI-assisted 개발 환경에서 코드 리뷰의 패러다임이 변화하고 있다. 기존 평면적인 diff 출력 대신, Hunk처럼 에이전트의 사고과정을 포함하여 리뷰할 수 있는 도구가 표준이 될 날이 가까워 보인다.

---

📚 출처

• https://github.com/modem-dev/hunk/

• https://deepwiki.com/modem-dev/hunk/1.1-getting-started