HexmosTech/git-lrc

git-lrc – 모든 `git commit` 시 실행되는 AI 기반 마이크로 코드 리뷰

개요 – 전역 Git 훅을 설치하는 (Go로 작성된) 명령줄 도구입니다. 변경 사항을 스테이징하고 git commit을 실행하면, 훅이 브라우저에서 짧은 UI를 실행하여 diff를 대규모 언어 모델(기본값 Gemini, OpenAI, Claude 등 연결 가능)로 전송합니다. 모델은 인라인 주석, 위험 점수, 변경 사항을 요약한 1페이지 슬라이드 덱을 반환합니다. 이후 다음 작업을 수행할 수 있습니다:

문제를 수정하고 리뷰를 다시 실행,
코드를 검토했음을 "보증"(vouch)하고 커밋 강행, 또는
리뷰를 완전히 건너뛰기.

모든 리뷰는 커밋 메시지에 기록되므로(예: LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)), 기록을 통해 어떤 변경 사항이 AI 검사를 거쳤는지 확인할 수 있습니다.

핵심 기능 (README 설명)

기능	제공 내용
자동 프리커밋 리뷰	모든 커밋 시 훅이 실행되며 추가 단계가 필요 없습니다.
이슈 내비게이터	10가지 위험 범주(보안, 신뢰성, 비용 등)에 걸친 구조화된 발견 뷰. 심각도, 유형, 영역별 필터링 제공.
위험 점수 diff 뷰	각 코드 블록(hunk)에 0-100점의 "폭발 반경" 및 "리뷰 우선순위" 점수가 부여되며, 고위험 블록이 우선 표시됩니다.
요약 슬라이드 덱	각 리뷰마다 생성되는 60초 분량의 슬라이드 덱(평이한 영어로 된 변경 설명 + 위험 강조).
에이전트 모드	CI 또는 AI 코딩 에이전트(Claude Code, Cursor 등)를 위한 비대화형 JSON 출력.
커넥터 관리자	자체 LLM API 키(Gemini, OpenAI, Claude, DeepSeek, Anthropic 호환, Atlas Cloud 등)를 추가하기 위한 UI.
피드백 루프	각 발견에 대한 좋아요/싫어요를 통해 향후 신호 대 잡음비를 개선합니다.
Git 로그 추적	리뷰 상태(실행됨, 보증됨, 건너뜀) 및 반복/커버리지 통계가 커밋 메시지에 추가됩니다.
크로스 플랫폼 설치	Linux/macOS용 원라인 설치 프로그램(`curl …
무료 티어	월 30k 코드 라인(LOC). 프리미엄은 100k LOC당 32달러부터 시작.

작동 방식 (상위 수준 흐름)

설정 – git lrc setup을 실행(또는 원라인 설치 프로그램 사용). LiveReview API 키(Hexmos 계정)와 Gemini API 키(또는 다른 커넥터)를 제공합니다. 도구는 전역 Git 훅을 설치하고 ~/.lrc/bin에 바이너리를 배치합니다.
커밋 – git add . → git commit … 시 자동으로 리뷰 UI가 실행됩니다.
리뷰 UI – GitHub 스타일의 diff, 인라인 AI 주석, 심각도 배지, 위험 점수가 매겨진 블록 목록을 표시합니다.
반복 – 표시된 문제를 수정하고 다시 git add .를 실행한 뒤 git lrc review를 실행합니다(또는 다시 커밋 시도). 도구는 반복 횟수(iter)와 최종 diff 중 AI 리뷰가 완료된 비율(coverage)을 추적합니다.
완료 – 만족스러우면 git lrc review --vouch("보증" 상태 기록) 또는 git lrc review --skip("건너뜀" 기록)을 실행합니다.
아티팩트 – 슬라이드 덱이 저장되고 커밋 메시지에 리뷰 상태 라인이 주석으로 추가됩니다.

설치 퀵스타트

# Linux / macOS (권장)
curl -L https://hexmos.com/ipm-install | bash && ipm i HexmosTech/git-lrc

# Windows (PowerShell)
iwr https://hexmos.com/ipm-install-ps | iex; ipm i HexmosTech/git-lrc

대체 스크립트: curl -fsSL https://hexmos.com/lrc-install.sh | bash (Linux/macOS) 또는 PowerShell 대응 명령.

설치 후 git lrc setup을 실행하여 LiveReview 및 Gemini(또는 기타) API 키를 연결하세요.

가격 요약

티어	무료 할당량	유료 가격(시작)	비고
개인 무료	월 30k LOC	–	자체 AI 키 필요. VS Code 확장 포함.
프리미엄	>30k LOC	$32 / 100k LOC (사용량에 따라 확장)	좌석당 요금 없음. 소규모 팀에 적합.
엔터프라이즈	맞춤형	맞춤형	자체 호스팅 옵션, SSO, 프라이빗 도메인, 엄격한 데이터 제어.

권장 사용자

엔지니어링 팀: LLM으로 코드를 생성하며 리포지토리에 반영 전 안전망이 필요한 팀.
기술 리드 / CTO: 여러 리포지토리에 걸쳐 정량화 가능한 리뷰 부채와 위험 기반 우선순위 지정을 원하는 리더.
CI 파이프라인: 비대화형 리뷰 단계가 필요한 파이프라인(git lrc review --agent-mode).
개인 개발자: IDE 확장 설치 없이 커밋 시 무료 AI 리뷰를 원하는 개발자.

제한 사항 및 고려 사항 (README)

외부 LLM API에 의존하므로 유효한 API 키를 제공해야 하며 사용 비용이 발생할 수 있습니다.
점수 산정(폭발 반경/리뷰 우선순위)에는 로컬 지식 그래프 바이너리가 필요합니다. 이는 선택 사항이며 --blast-radius=false로 비활성화할 수 있습니다.
무료 티어는 월간 처리 코드 라인 수에 제한이 있습니다. 헤비 유저는 유료 플랜이나 자체 호스팅 엔터프라이즈 배포가 필요합니다.

결론

git-lrc는 AI 기반 코드 리뷰를 Git 커밋 워크플로우에 직접 도입하는 진정한 오픈 소스(MIT 스타일) Go 프로젝트입니다. 위험 탐지 자동화, 검색 가능한 UI 제공, Git 기록에 리뷰 증적 기록을 통해 LLM 생성 코드가 도입할 수 있는 검증되지 않은 변경 사항에 대한 "브레이크" 역할을 목표로 합니다.