Jev-Code-Reviewer

에이전트가 생성하는 대부분의 PR(Pull Request)은 사람이 이해하기 어려울 정도로 한 번에 많은 파일 변경 사항을 보여줍니다. 이는 각 검토 변경 사항을 P0, P1, P2로 분류하여 정신적 부담을 줄이려는 시도입니다. 기본적으로는 P0만 표시됩니다. 우선순위는 설정 가능하며, diff(차이점) 역시 자연어로 표시됩니다. 원본 코드는 토글 하나만 거르면 볼 수 있습니다.

이는 사용자의 컴퓨터에서 실행되며, 사용자가 직접 만든 코딩 에이전트의 PR을 검토하고, GitHub에 아무것도 게시하지 않습니다.

녹화 영상 보기 · 데모 PR 열기. 번들된 녹화 영상은 실제 Jev 분류와 레이블이 지정되고 준비된 설명 복사본(provenance)을 사용합니다.

빠른 데모

Node.js 22 이상 필요.

git clone https://github.com/egma-ai/jev-code-reviewer.git
cd jev-code-reviewer
npm install
...

재생을 위해 http://127.0.0.1:4731/demo를 열거나, 확장 프로그램을 로드(아래)하여 데모 PR의 파일 변경 페이지를 엽니다.

사용자의 PR 검토하기

GitHub CLI에 로그인(gh auth login)되어 있어야 하며, origin이 해당 PR의 저장소인 로컬 클론이 필요합니다.

npm link                 # jev-reviewer 명령어 추가
jev-reviewer setup       # TypeSafe 및 OpenAI 키를 저장합니다. 자체 터미널에서 실행하세요.
jev-reviewer doctor      # 도구, 키 소스, 로컬 서버 및 제공업체 액세스를 확인합니다.
...

그런 다음 Chrome에서:

1. chrome://extensions를 열고 **개발자 모드(Developer mode)**를 켠 후, **압축 해제된 확장 프로그램 로드(Load unpacked)**를 클릭하고 이 저장소의 extension/ 폴더를 선택합니다.
2. jev-reviewer token | pbcopy를 실행합니다. 확장 프로그램 팝업에서 **연결(Connection)**을 열고 붙여넣기한 후 **저장(Save)**을 클릭합니다. Paired라고 표시되어야 합니다.
3. PR의 파일 변경 페이지(/pull/<n>/files)를 열고 **코드 대신 로직 표시(Show logic in place of code)**를 켭니다.

선택 사항: uv tool install graphifyy는 더 나은 컨텍스트를 위해 로컬 코드 그래프를 추가합니다. 코딩 에이전트가 PR을 연 후 analyze를 실행하려면 에이전트 스킬을 설치하세요.

알아두면 좋은 점

• 코드가 기기를 벗어납니다. analyze는 변경된 코드와 주변 컨텍스트를 TypeSafe 및 OpenAI로 전송합니다. 이 확장 프로그램은 127.0.0.1:4731의 로컬 서버와만 통신합니다.
• 키는 ~/.config/jev-reviewer/credentials.json에 저장됩니다 (소유자 전용, 암호화되지 않음). 코딩 에이전트의 셸에서 종종 볼 수 없는 환경 변수보다 이것을 선호하세요. OpenAI 키를 교체하려면 node scripts/setup-keys.mjs --replace-openai를 실행하세요.
• 커버리지는 제한됩니다. 경로 순서상 처음 12개의 변경 단위(diff hunks)가 분석되며, --max-units는 최대 100개까지 허용합니다. 분석되지 않은 변경이 있는 파일은 GitHub의 코드를 유지하며, CLI와 팝업에서 몇 개인지 알려줍니다.
• 클래식 '파일 변경' 페이지만 지원됩니다. GitHub의 새로운 /changes 페이지는 아직 지원하지 않습니다. 프로필 사진 아래 → 기능 미리 보기로 돌아가세요.
• 이전 보고서는 절대 표시되지 않습니다. PR에 더 최신 커밋이 있는 경우, 확장 프로그램은 GitHub의 코드를 유지합니다: analyze를 다시 실행한 다음 보고서 새로 고침을 클릭하세요.
• 우선순위는 정확도가 아닌 주의 집중도를 의미합니다. P0 파일이 기본적으로 열리고; P1과 P2는 접힌 상태로 시작됩니다. 검토된 저장소의 config/policy.json을 .jev-reviewer.json으로 복사하거나 --policy를 전달하여 조정하세요.

개발

pm test
node scripts/test-extension.mjs   # Chromium 및 포트 4731이 비어 있어야 함

아키텍처, 데모 가이드, 그리고 확장 프로그램 세부 정보를 확인하세요.

MIT.