Revdiff: AI 에이전트를 위한 인라인 주석이 포함된 터미널 Diff 뷰어

Revdiff의 기능

Revdiff는 특정 워크플로우를 위해 설계된 터미널 사용자 인터페이스(TUI) diff 뷰어입니다: AI 에이전트가 실행되는 터미널 세션을 떠나지 않고 AI 생성 코드 변경 사항을 검토하는 것입니다. 이 도구를 사용하면 라인, 덩어리 또는 파일에 주석을 달고 해당 주석을 AI 에이전트에 직접 전달하여 처리할 수 있습니다.

핵심 워크플로우

Claude Code 세션에서 /revdiff main을 입력하거나 "마지막 3개 커밋에 대한 diff 검토"라고 말하면 에이전트 세션 위에 터미널 오버레이로 revdiff가 열립니다. diff를 읽고 주석을 추가한 후 종료하면 주석이 에이전트로 바로 돌아갑니다. 에이전트가 변경 사항을 완료하면 revdiff가 자동으로 새로운 변경 사항에 대해 다시 열려, 주석 없이 종료할 때까지 지속적인 루프를 생성합니다.

계획 통합

별도의 revdiff-planning 플러그인이 Claude Code의 계획 모드에 연결됩니다. 에이전트가 계획을 완료하고 ExitPlanMode를 호출하면 revdiff가 계획 텍스트에 자동으로 열립니다. 동의하지 않거나 확장하고 싶은 부분에 주석을 달고 종료하면 에이전트가 코드를 작성하기 전에 계획을 수정합니다.

주요 기능

• 두 개의 창 TUI: 왼쪽에 파일 트리, 오른쪽에 구문 강조된 diff
• /검색, 덩어리 점프 및 단어 수준 변경 강조 기능이 있는 Vim 스타일 탐색
• 라인별 작성자 이름과 커밋 기간을 표시하는 책임 표시 줄
• 변경 마커가 있는 최종 텍스트를 표시하는 축소된 diff 모드
• 연속 마커가 있는 단어 줄바꿈 모드
• « / » 마커가 있는 가로 스크롤 오버플로 표시기
• diff를 위한 이전/새로운 줄 번호 측면 표시 줄
• 자동 감지 및 git 스타일 참조 변환이 있는 Mercurial 지원
• 전체 너비 diff 보기를 위해 트리 창을 숨기는 단일 파일 자동 감지
• 파일 전체의 모든 주석을 탐색할 수 있는 주석 목록 팝업
• 파일 이름, diff 통계, 덩어리 위치 및 모드 표시기가 있는 상태 줄
• 섹션별로 구성된 모든 키 바인딩을 표시하는 도움말 오버레이
• 단일 파일 마크다운 파일을 위한 마크다운 목차 탐색
• 모든 git 추적 파일을 탐색하고 주석을 달 수 있는 전체 파일 모드
• 저장소 외부 파일을 위한 비-git 파일 검토
• 임의의 파이프 또는 리디렉션된 텍스트를 위한 스크래치 버퍼 검토
• ~/.config/revdiff/history/에 자동 저장되는 검토 기록

사용자 정의

Revdiff는 7개의 번들 색상 테마, 재매핑 가능한 키 바인딩, CLI 플래그, 환경 변수 또는 구성 파일을 통한 색상별 재정의를 제공합니다. --dump-keys로 기본 키 바인딩을 내보낼 수 있습니다.

설치 및 사용법

Homebrew를 통해 설치: brew install umputun/apps/revdiff. 이 도구는 단일 바이너리입니다 - 마지막 3개 커밋을 검토하려면 revdiff HEAD~3을 실행하세요. git 및 Mercurial 저장소와 함께 작동합니다.

플러그인 지원

Claude Code(tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2 또는 Emacs vterm을 통한 터미널 오버레이), Codex 및 pi용 플러그인이 준비되어 있습니다. Claude Code 플러그인은 Claude Code 자체가 대화형 TUI 애플리케이션을 표시할 수 없기 때문에 지원되는 터미널 중 하나가 필요합니다.

기술적 세부 사항

Go로 작성되었으며 MIT 라이선스 하에 오픈 소스입니다. diff 생성에는 git 또는 hg가 필요합니다(--only 또는 --stdin 사용 시 선택 사항).