kodus-ai

AI Coding ToolsCLITypeScript

★ 1,369주당 +27조회 4

무엇인가

Kodus는 풀 리퀘스트에 붙어 코드 리뷰를 수행하는 AI 리뷰 시스템이다. 호스팅 리뷰 봇이 모델과 요금을 통제하던 자리를 대체하며, 자체 인프라에 올려 데이터와 런타임 설정을 직접 쥐는 배포를 전제로 한다.

어떻게 동작하나

저장소는 API, worker, webhooks 서비스, 웹 앱, 로컬 인프라로 나뉜 모노레포다. Git 제공자가 보낸 웹훅을 webhooks 서비스가 받아 API로 넘기고, worker가 리뷰 작업을 꺼내 모델 호출과 코멘트 작성을 수행한다. 리뷰 시점에 Kody Rules가 컨텍스트로 주입되며, 닫힌 PR에서 반영되지 않은 제안은 Kody Issues로 남아 이후 PR에서 수정이 나타나면 해소된다. Cockpit은 리뷰 효과, Kody Rule 상태, 저장소 상태, 배포 지표를 집계한다.

무엇과 다른가

모델 선택을 고정하지 않는다. Claude, GPT-5, Gemini, Llama, GLM, Kimi를 비롯해 OpenAI 호환 엔드포인트면 무엇이든 연결하고, 자격 증명은 사용자 제공자 계정에 둔다. LLM 비용에 마크업을 붙이지 않고 제공자에 직접 지불하며, 토큰 사용량을 리뷰 단위로 추적한다. 리뷰 규칙도 고정 세트가 아니라 자연어로 조직·저장소·경로·리뷰 범위별로 정의한다.

어떻게 쓰나

저장소를 클론한 뒤 yarn setup으로 로컬 환경을 구성한다. CLI에서는 kodus review로 작업 트리, 스테이징 diff, 브랜치, 커밋을 대상으로 리뷰를 돌리고 --staged, --prompt-only 같은 플래그로 범위와 출력을 바꾼다. 같은 명령을 CI/CD 파이프라인에 넣어 파이프라인 안에서 리뷰를 실행한다.

전제와 한계

동작하려면 Git 제공자 연동과 자체 LLM 제공자 자격 증명이 필요하다. 셀프호스팅 인스턴스는 하루 한 번 익명 하트비트를 보내며 집계 카운터만 포함하고 코드·이름·식별자는 담지 않는다. KODUS_TELEMETRY_DISABLED=true로 끌 수 있다. 소스 코드는 모델 학습에 쓰이지 않고 전송 중과 저장 시 암호화된다.