persiyanov/herdr-reviewr

herdr‑reviewr – herdr를 위한 터미널 기반 코드 리뷰 패널

무엇인가요

• herdr AI 어시스턴트 터미널 UI용 플러그인으로, 에이전트가 최근에 작성한 파일의 실시간 차이점을 표시합니다. 변경 내용을 스크롤하며 특정 줄에 주석을 달 수 있고, 터미널을 벗어나지 않고도 주석을 에이전트에게 전송할 수 있습니다.
• 채팅 창 옆의 분할 패널로 작동하거나, 독립형 터미널 프로그램으로도 사용할 수 있습니다.

주요 기능

• 네 가지 차이점 범위 – 커밋되지 않은 변경 사항, 전체 브랜치, 에이전트의 이전 '턴', 또는 임의의 커밋 세트를 볼 수 있습니다.
• 줄 단위 주석 – 줄 선택 (v), 주석 입력 (c), 편집/삭제 (e/d), 모든 주석을 에이전트에게 전송 (s).
• 나비게이터 – 퍼지 파일 검색, 실시간 grep (via the fff 도구), Markdown도 렌더링 가능한 파일 뷰어.
• PR 탭 – GitHub, GitLab, Azure DevOps의 현재 풀 리퀘스트/머지 리퀘스트를 읽기 전용으로 보여줍니다 (각각의 CLI 도구 필요).
• 테마 및 UI – 18개의 내장 다크/라이트 테마, --theme 또는 TOML 설정 파일로 구성 가능.
• 사용자 정의 키바인딩 – 모든 작업을 재할당 가능; 기본값은 README에 나와 있습니다.

설치 방법

1. herdr 설치 시 (≥ 0.7.5):

   herdr plugin install persiyanov/herdr-reviewr
   herdr plugin action invoke open --plugin persiyanov.reviewr
   

2. 스탠드얼론 (herdr 없이): 릴리스 페이지에서 사전 빌드된 바이너리를 다운로드하여 리포지토리에 대해 실행:

   herdr-reviewr ~/my/project
   

   (UI만 작동; "보내기" 및 "마지막 턴" 범위는 herdr 필요)

구성

• CLI 플래그: --poll <ms>, --base <ref>, --theme <name>, --wrap on|off.
• 지속적인 TOML 파일: ~/.config/herdr/plugins/config/persiyanov.reviewr/config.toml 에서 theme, default_scope, 나비게이터 위치, 에디터 명령, 사용자 정의 키바인딩 등의 기본값 설정 가능.
• .gitignore를 존중하며, 큰 파일 (> 2 MiB 또는 50k 줄)은 차이점에서 제외됩니다.

제한 사항

• 진정한 색상 터미널과 유니코드 박스 그리기 문자 필요; 256색 터미널에 대한 대체 없음.
• macOS 또는 Linux만 지원; Windows 미지원.
• 클립보드 통합은 pbcopy, wl-copy, xclip, xsel에 의존.
• 주석은 현재 세션 내에서만 메모리에 존재; 패널을 닫으면 전송되지 않은 주석은 사라짐.
• "보내기"는 herdr 워크스페이스에 에이전트가 존재할 때만 작동.
• PR 보기 읽기 전용이며, 각 스레드의 최대 100개의 댓글만 표시.

로드맵 주요 사항

• 주석의 구조화된 JSON 내보내기.
• 사이드바이사이드 분할 뷰.
• OSC를 통한 자동 라이트/다크 테마 감지.
• 추가 테마 (예: kanagawa, everforest) 및 OSC-52 클립보드 지원.

라이선스

• 코드는 MIT 라이선스.
• 구문 강조 자산은 syntect 및 two-face의 각각의 라이선스에 따라 제공됩니다.

---

herdr‑reviewr는 herdr 터미널 UI 내에서 AI 코드 에이전트를 사용하는 개발자들이 콘솔을 떠나지 않고도 키보드 중심으로 생성된 코드를 집중적으로 리뷰하고 주석을 달 수 있는 실용적인 도구입니다.