코드베이스 검색을 위한 AI 에이전트 도구 jevgrep 소개
dzhng/jevgrep
GitHub프로젝트의 특정 기능에 대해 질문하면, jevgrep이 관련 파일 목록과 구체적인 소스 코드 발췌본을 한 번에 제공하는 검색 도구입니다.
- 벤치마크 결과, 기존 방식과 동일한 문제 해결 능력을 유지하면서도 코딩 에이전트 운영 비용을 약 30% 절감하는 효과를 입증했습니다.
- 방대한 코드베이스에서 특정 기능의 위치나 구현 방식을 찾기 어려울 때, 필요한 정보를 효율적으로 탐색하여 개발 생산성을 높일 수 있습니다.
- 사용을 위해서는 Node.js 22+ 환경과 Vercel AI Gateway 등의 외부 API 키가 필요하며, 검색 결과는 참고 자료일 뿐 완벽한 정답을 보장하지 않습니다.
Jevgrep은 코드베이스에 대한 질문을 통해 관련 파일을 찾아주는 CLI 도구입니다. 코딩 가 작업 중 파일 탐색 과정에서 어려움을 겪는 부분을 보완하며, 리포지토리 전체에 질문을 던지면 관련된 파일 목록, 읽기 단서(reading leads), 그리고 원문 발췌본을 하나의 표준 출력으로 제공합니다. 이는 Jev 모델을 사용하여 폴더, 파일, 선언 전반의 관련성을 판단하여 코딩 에이전트가 변경 사항을 구현하고 테스트할 수 있는 근거를 마련해 줍니다.
SWE-bench 비교 테스트 결과에 따르면, Jevgrep은 기존 방식과 동일하게 10개 중 8개의 과제를 성공적으로 완료했습니다. 이 과정에서 코딩 에이전트의 운영 비용 절감 효과가 입증되었는데, Sol 단독 기준으로 $7.62에서 $5.44로 감소하여 측정된 28.6% (약 30%)의 비용 절감을 보였습니다.
사용을 위해서는 Node.js 22+ 환경과 macOS 또는 Linux 운영체제가 필요하며, Vercel AI Gateway 등 외부 키 설정이 요구됩니다. CLI를 설치하는 것 외에도 코딩 에이전트가 이 도구를 사용하도록 '스킬'을 별도로 설치해야 합니다. 기본적인 사용 흐름은 `npm install -g @dzhng/jevgrep` 명령어로 CLI를 설치한 후, `jg "질문 내용" ./프로젝트경로`와 같이 질문과 프로젝트 경로를 지정하여 실행할 수 있습니다.
용어 풀이
- 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.
- API
- 프로그램끼리 기능을 주고받는 약속된 창구. AI 모델은 보통 API로 불러 써요.