git-lrc

git-lrc: 커밋 시 실행되는 무료 무제한 AI 코드 리뷰 도구

현재 생성형 AI(GenAI)는 브레이크 없는 경주용 자동차와 같습니다. 설명만 하면 순식간에 방대한 코드 블록을 만들어내며 개발 속도를 비약적으로 높여주지만, 동시에 위험 요소도 존재합니다.

AI 에이전트는 때때로 로직을 삭제하거나, 제약 조건을 완화하고, 값비싼 클라우드 호출을 추가하거나, 자격 증명을 유출하는 등 예상치 못한 문제를 일으킬 수 있습니다. git-lrc는 이러한 AI 코드 생성의 가속도에 제동을 걸어주는 필수적인 브레이킹 시스템입니다. git-lrc는 git commit 단계에서 훅(hook)을 실행하여 모든 diff가 반영되기 전에 AI 리뷰를 수행합니다.

git-lrc란 무엇인가요? (What's git-lrc)

git-lrc는 소스 코드가 공개된 오픈 소스 기반의 도구로, 개발자가 코드를 커밋할 때마다 AI가 자동으로 코드 리뷰를 진행할 수 있도록 돕는 Git Hook 솔루션입니다. Google의 Gemini API를 활용하여 무료로 무제한 리뷰를 제공하며, 개발자가 직접 API 키를 가져와 사용하기 때문에 중간 결제 단계가 없는 투명한 구조를 가지고 있습니다.

이 도구는 AI 에이전트(Cursor, Windsurf, Copilot 등)가 작업한 코드를 그대로 배포하기 전에 한 번 더 검토함으로써, 보안 위협이나 성능 저하를 방지하는 마지막 방어선 역할을 합니다.

주요 기능 (Features)

1. AI 기반의 즉각적인 이슈 감지

git-lrc는 단순히 코드를 읽는 것이 아니라 다음과 같은 치명적인 문제들을 포착합니다.

• 자격 증명 유출: 코드 내에 포함된 민감한 API 키나 비밀번호 감지
• 비싼 클라우드 작업: 불필요하게 높은 비용을 유발하는 클라우드 호출 식별
• 로그 내 민감 데이터: 로그 파일에 기록된 중요한 정보 노출 차단
• 침묵의 로직 제거: 의도치 않게 삭제된 필수 로직 및 행동 변화 감지

2. 강력한 리뷰 UI 제공

웹 브라우저에서 실행되는 UI를 통해 직관적인 리뷰 경험을 제공합니다.

• GitHub 스타일 Diff: 색상으로 구분된 추가 및 삭제 라인 확인
• 인라인 AI 코멘트: 정확한 코드 라인에 심각도 배지와 함께 의견 표시
• 리뷰 요약: 발견된 문제점에 대한 고수준의 개요 제공
• 스테이징 파일 목록: 스테이징된 파일을 한눈에 보고 빠르게 이동
• 이슈 사이클링: 스크롤 없이 코멘트 간 이동 가능

3. Git 로그 추적 및 가시성

모든 커밋 메시지 끝에 리뷰 상태가 기록됩니다. 팀원들은 git log를 통해 해당 커밋이 리뷰되었는지, 보증(Vouch)되었는지, 혹은 건너뛰었는지(Skip)를 확인할 수 있습니다.

• iter: 커밋 전 반복된 리뷰 횟수 표시
• coverage: 이전 반복에서 AI가 이미 검토한 최종 diff의 백분율 표시

사용 사례 (Use Case)

• AI 에이전트 협업: Cursor나 Copilot이 작성한 대량의 코드를 검토할 때 유용합니다.
• 보안 강화: 민감한 정보가 저장소에 push되기 전에 로컬에서 먼저 차단하고 싶을 때 적합합니다.
• 팀 코드 품질 유지: 정기적인 리뷰 습관을 빌드 프로세스에 녹여내어 버그를 줄이고 더 견고한 코드를 만들고 싶을 때 사용합니다.
• 범용 IDE 환경: Git은 범용적이므로 어떤 에디터나 IDE를 사용하더라도 git-lrc를 통해 일관된 리뷰 프로세스를 가질 수 있습니다.

설치 방법 (Install)

git-lrc는 약 1분 만에 설치 및 설정을 완료할 수 있습니다.

1단계: 설치

macOS 및 Linux 사용자는 다음 명령어를 실행합니다.

curl -fsSL https://hexmos.com/lrc-install.sh | sudo bash

2단계: 설정 (약 1분 소요)

git lrc setup

이후 브라우저에서 두 가지 단계가 진행됩니다.

1. Hexmos를 통해 LiveReview API 키 발급 및 로그인
2. Google AI Studio에서 무료 Gemini API 키 발급

설정이 완료되면 시스템 전체에 적용되어 모든 Git 저장소에서 커밋 시 자동으로 리뷰가 트리거됩니다.

사용 방법 (How to Use)

자동 리뷰 모드

평소처럼 작업을 마치고 커밋을 시도하면 자동으로 리뷰 UI가 실행됩니다.

git add .
git commit -m "결제 유효성 검사 추가"
# 리뷰 UI가 자동으로 실행됨

수동 리뷰 모드

커밋하기 전에 미리 리뷰를 진행하고 싶을 때 사용합니다.

• 리뷰 실행: git lrc review
• 보증 후 커밋: git lrc review --vouch (AI를 건너뛰고 직접 책임짐)
• 리뷰 건너뛰기: git lrc review --skip

리뷰 사이클 워크플로우

1. AI 에이전트로 코드를 생성합니다.
2. git lrc review를 실행하여 AI의 피드백을 확인합니다.
3. 발견된 문제를 에이전트에게 전달하여 수정하고 다시 리뷰합니다.
4. 준비가 되면 수락하고 커밋(Accept and commit)을 진행합니다.

FAQ

Q: 어떤 데이터가 전송되나요? A: 오직 스테이징된 diff(코드 차이점)만 분석됩니다. 전체 저장소 컨텍스트는 업로드되지 않으며, 리뷰가 완료된 후 diff 데이터는 저장되지 않습니다.

Q: 특정 저장소에서만 git-lrc를 비활성화할 수 있나요? A: 네, 가능합니다. 해당 저장소에서 git lrc hooks disable 명령어를 사용하면 훅이 비활성화되며, 나중에 git lrc hooks enable로 다시 켤 수 있습니다.

Q: 이미 커밋된 과거의 코드도 리뷰할 수 있나요? A: 네, git lrc review --commit HEAD 명령어를 통해 마지막 커밋을 리뷰하거나, git lrc review --commit HEAD~3..HEAD와 같이 범위를 지정하여 리뷰할 수 있습니다.

Q: 왜 무료인가요? A: git-lrc는 소스 공개형 프로젝트이며, Google Gemini API의 넉넉한 무료 티어를 사용합니다. 사용자가 본인의 API 키를 직접 사용하므로 중간 비용이 발생하지 않습니다.

---

git-lrc를 지금 설치하고 다음 커밋부터 더 안전하고 견고한 코드를 작성해 보세요. 오픈 소스 프로젝트에 참여하거나 이슈를 제기하려면 GitHub를 방문해 주세요.