자연어 질문으로 코드 리포지토리를 검색하는 CLI 도구 'Jevgrep'
dzhng/jevgrep
GitHubJevgrep은 자연어 질문을 통해 대규모 코드 리포지토리 전체에서 필요한 파일 위치와 관련 소스 코드를 찾아주는 CLI 도구입니다.
대규모 코드 리포지토리에서 필요한 코드를 자연어 질문만으로 찾아내고, 기존 방식 대비 운영 비용까지 절감할 수 있다는 점이 개발자에게 중요해요.
- 벤치마크 결과, 기존 에이전트와 동일한 성능(8/10)을 유지하면서도 운영 비용을 약 30% 절감하는 효율성을 입증했습니다.
- 특정 기능의 구현 위치나 작동 방식을 모를 때, 이 도구는 리포지토리 전체 구조를 탐색하여 필요한 코드 조각을 효과적으로 찾아냅니다.
- 사용하려면 Node.js 22+ 환경과 외부 API 키가 필요하며, 검색 결과는 참고 자료일 뿐 최종 코드를 보장하지 않음에 유의해야 합니다.
Jevgrep은 대규모 코드 리포지토리 전체에서 자연어 질문을 통해 필요한 파일 위치와 관련 소스 코드를 찾아주는 CLI 도구입니다. 이 도구는 기존의 기반 검색 방식과 동일한 수준의 지능을 유지하면서도 운영 비용을 약 30% 절감하는 효율성을 입증했습니다. Jevgrep은 코드 에이전트가 익숙하지 않은 작업을 수행할 때 필요한 파일을 찾는 과정을 지원하며, 사용자가 리포지토리에 질문을 던지면 관련 파일, 읽기 경로(reading leads), 그리고 원문 소스 발췌본을 한 번의 응답으로 반환합니다.
Jevgrep은 리포지토리 계층 구조를 탐색하고 적격한 브랜치를 따라가며 파일을 선택합니다. 이 과정에서 Jev 모델을 사용하여 폴더, 파일 및 선언 전반에 걸쳐 관련성을 판단하며 유용한 소스 단위와 주변 컨텍스트를 식별합니다. 검색 결과는 요약과 간결한 파일 목록으로 먼저 제시되며, 이후 라인 참조가 포함된 선택된 소스와 상세한 선언/호출 위치 정보가 제공됩니다. 이 출력물은 에이전트가 활용할 수 있는 증거 자료이며, 모든 관련 파일을 찾았음을 보장하는 답변이나 결과는 아닙니다.
Jevgrep을 사용하려면 Node.js 22 이상 버전과 Vercel AI Gateway, TypeSafe 등 선택한 제공업체의 키가 필요합니다. 설치 시에는 CLI를 전역으로 설치하고, 에이전트에게 이 도구를 사용하도록 가르치는 '스킬'도 별도로 설치해야 합니다. 예를 들어, `npm install -g @dzhng/jevgrep` 명령어로 CLI를 설치한 후, `jg skill`을 통해 에이전트 스킬까지 설정하는 과정이 필요합니다. 이 도구는 사용자가 이해하고자 하는 동작의 위치나 작동 방식을 모를 때 가장 유용하게 활용될 수 있습니다.
용어 풀이
- 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.
- API
- 프로그램끼리 기능을 주고받는 약속된 창구. AI 모델은 보통 API로 불러 써요.
Jevgrep은 어떤 원리로 관련 소스 코드를 찾나요?
리포지토리의 계층 구조를 탐색하고 적절한 브랜치를 따라가면서 파일을 선택해요. 이 과정에서 Jev 모델을 사용해 폴더, 파일 및 선언 전반에 걸쳐 관련성을 판단하여 유용한 소스 단위와 주변 컨텍스트를 식별합니다.
검색된 결과가 최종 코드를 보장하는 자료인가요?
아니에요. 검색 결과는 에이전트가 활용할 수 있는 참고 자료나 증거 자료일 뿐이며, 모든 관련 파일을 찾았음을 보장하거나 최종 코드를 의미하지 않아요.