프로젝트 소개

jevgrep은 코딩 에이전트를 위한 명령줄 도구로, 수동 파일 탐색 과정의 일부를 자연어 검색으로 대체합니다. 파일 이름을 추측하거나 심볼을 grep하는 대신, 사용자가 "원격 측정 이벤트는 어떻게 기록되고 전송되나요?"와 같은 질문을 하면 도구가 저장소 계층 구조를 탐색하고, 콘텐츠 미리보기를 사용해 파일을 선택하며, 관련 소스 단위를 식별한 후 요약, 간결한 파일 목록, 줄 참조가 포함된 원문 소스 발췌, 선언 또는 호출 위치를 하나의 stdout 응답으로 반환합니다. 이 도구는 Jev를 구성 가능한 제공자를 통해 사용하여 폴더, 파일, 선언 전반의 관련성을 판단합니다. 지원되는 제공자로는 Vercel AI Gateway, TypeSafe, OpenRouter, OpenCode Zen, 그리고 사용자 지정 TypeSafe 호환 엔드포인트가 있습니다. macOS 또는 Linux에서 Node.js 22+가 필요하며 Python, Bun, ripgrep을 별도로 설치할 필요가 없습니다. 동반 에이전트 스킬은 `jg skill` 또는 `npx skills add dzhng/jevgrep --skill jevgrep`을 통해 사용할 수 있습니다. 설치 프로그램은 Claude Code, Codex, OpenCode와 같은 코딩 에이전트를 감지하고 CLI 호출 방법과 반환된 컨텍스트 해석 방법을 설명합니다. 인증은 `jg auth`로 처리되며, 제공자 키를 소유자 전용 구성 파일에 저장합니다. 선언 파싱은 Python, TypeScript/JavaScript, Go, Rust에 대해 지원되며, 기타 텍스트에 대한 폴백이 있습니다. 기본 파일 시스템 필터링은 ignore 파일을 존중하고 숨김 파일, 의존성/빌드 파일, 바이너리 파일, 명백한 자격 증명 파일을 제외합니다. `jg files` 명령은 네트워크 요청 없이 검색이 읽을 수 있는 파일 수를 계산하며, `--exclude`는 검색별 제외를 위해 gitignore 스타일 패턴을 허용합니다. 저장소에는 조정된 10개의 Python SWE-bench 작업을 기반으로 한 평가 기록이 포함되어 있습니다. 이 프로젝트는 Jevgrep이 Jev를 사용하지 않는 기준선과 동일하게 10개 작업 중 8개를 해결하면서 측정된 Sol 비용을 약 28.6% 절감했다고 보고하며, 이후 평가에는 Sol과 Jev 비용을 합산한 측정값이 포함됩니다. 이는 통계적 보장이 아닌 단일 실행 관찰 결과입니다. 이 프로젝트는 Bun 워크스페이스와 Turborepo를 사용하여 TypeScript로 작성되었으며, MIT 라이선스로 배포됩니다.