AI 칼럼

코딩@donghyeok99운영진

Jevgrep: 하는 일을 물으면 그 코드를 찾아 주는 CLI

2,761개 파일 저장소에 한국어로 20번 물었더니 20번 모두 맞는 파일이 맨 위에 나왔다는 측정이 올라왔어요

jg에 질문을 치면 저장소의 폴더를 훑어 관련 파일 세 개에만 불이 켜지고, 그 원문이 줄 번호와 함께 나온 뒤 End context.로 끝나요.
jg에 질문을 치면 저장소의 폴더를 훑어 관련 파일 세 개에만 불이 켜지고, 그 원문이 줄 번호와 함께 나온 뒤 End context.로 끝나요.
누가
David Zhang(dzhng)이 만들었어요. 낯선 저장소에서 맞는 파일부터 찾아야 하는 코딩 에이전트와 그 사용자를 위한 CLI예요.
언제
2026년 9월 26일 공개. 마지막 GitHub 릴리스는 10월 1일 0.8.0(Windows 지원)이고, 태그는 v0.8.5까지 나왔어요.
어디서
Claude Code, Codex, OpenCode 등에 스킬로 설치해요. macOS·Linux·Windows, Node.js 22 이상. 판단은 선택한 제공자를 거친 Jev가 해요.

이게 불편했어요

낯선 저장소에서 '요청이 핸들러에 닿기 전에 인증은 어디서 확인하지?'를 알아야 할 때, 함수 이름을 모르면 grep으로는 잘 안 잡혀요. 코딩 에이전트도 낯선 작업마다 맞는 파일을 찾는 데 한참을 쓰고, 그만큼 비용이 나가요.

그래서 이렇게 풀어요

jg에 동작을 묻는 질문을 던지면, Jev가 폴더와 파일, 선언 하나하나가 그 질문과 관련 있는지 판단해요. 관련 있다고 본 가지만 따라 들어가고, 고른 소스는 고치지 않은 원문 그대로 줄 번호와 함께 돌려줘요. 답을 지어내지 않고 증거만 넘기니, 고치고 테스트하는 일은 에이전트에게 남아요.

README의 비교: Jevgrep이 있든 없든 10개 중 8개를 풀었고, 코딩 에이전트 비용은 약 30% 낮았어요
README의 비교: Jevgrep이 있든 없든 10개 중 8개를 풀었고, 코딩 에이전트 비용은 약 30% 낮았어요

이걸로 만든 사람들

GitHub@lslogis2026-09-29

자기 프로젝트(165개 파일)에서 잘 돼서 Wan2GP(2,761개 파일)에 한국어 질문 20개로 재 봤어요. 20개 모두 정답 파일이 맨 위였지만, 질문당 중앙값 65초와 약 500만 토큰이 들었다고 적었어요.

Accuracy on the large repo was excellent: the correct file was ranked first for all 20 queries.
댓글 2 (2026-10-29 기준)GitHub ↗
GitHub@oconnorjoseph2026-09-29

자기 코딩 에이전트 하네스에 jg를 연결해 쓴 팀이에요. 범위가 분명한 질문엔 맞는 파일을 먼저 찾지만, 답이 없는 폴더에 물으면 파일의 41%를 관련 있다고 표시하고 5.4MB를 출력했다고 측정해 올렸어요.

We wired it into our coding-agent harness and it finds the right file first on well-scoped questions.
댓글 1 (2026-10-29 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    Claude Code · Codex → jevgrep 스킬

    어떻게·어디서를 묻는 질문스킬 설명이 동작을 묻는 질문은 grep보다 jg로 먼저 찾으라고 에이전트에게 알려요.skills/jevgrep/SKILL.md
  2. 2

    jevgrep 스킬 → jg CLI

    jg "질문" 경로CLI가 질문과 검색 루트를 읽고, jg auth로 저장해 둔 제공자 키를 불러와 검색을 시작해요.apps/cli/src/index.ts
  3. 3

    jg CLI → 저장소 파일

    보낼 수 있는 파일만 읽기ignore 파일, 숨김·의존성·바이너리 파일, .env와 비밀값처럼 보이는 파일은 빼고 읽어요.packages/core/src/filesystem.ts
  4. 4

    저장소 파일 → Jev (AI Gateway 등)

    폴더·파일 미리보기 묶음트리를 내려가며 미리보기를 묶어 보내고, 관련 있다고 판단된 가지만 더 열어 봐요.packages/core/src/retrieve.ts
  5. 5

    Jev (AI Gateway 등) → jg CLI

    관련성 판단, 로컬 캐시판단은 AI SDK로 오가며 재시도와 요청 속도 한도를 지키고, 답은 로컬에 캐시해 둬요.packages/core/src/evaluator.ts
  6. 6

    jg CLI → stdout 컨텍스트

    요약, 파일 목록, 원문 발췌상태와 파일 목록이 먼저, 줄 번호가 붙은 소스 블록, 선언 위치가 이어지고 End context.로 끝나요.apps/cli/src/render.ts

넣으면 이렇게 나와요

jg "How are telemetry events recorded and sent?"src/telemetry.ts, src/backend/events.ts, tests/telemetry.test.ts의 원문 발췌(README가 링크한 출력 예시)
2,761개 파일 저장소(Wan2GP)에 한국어 질문 20개20개 모두 정답 파일이 1위, 질문당 중앙값 65초·약 $0.22(이슈 #38의 측정)

나한테 맞을까요

이럴 때 좋아요

  • 낯선 저장소에서 어떤 동작이 어디 있는지, 이름은 모를 때
  • Claude Code·Codex·OpenCode에 '찾아보고 고치기'를 맡길 때
  • 요청에서 핸들러까지처럼 여러 파일에 걸친 흐름을 따라갈 때
  • 어떤 테스트가 어떤 동작을 덮는지 찾을 때

이건 안 돼요

  • Vercel AI Gateway, TypeSafe, OpenRouter, OpenCode Zen 또는 호환 엔드포인트의 키가 필요하고, jg auth로 저장해 둬야 해요.
  • 검색하는 폴더의 소스가 Jev로 보내져요. .env와 비밀값처럼 보이는 파일은 빼지만, README는 이를 최선의 노력이지 보장은 아니라고 해요.
  • 결과는 에이전트가 쓸 증거일 뿐, 관련 파일을 모두 찾았다는 보장은 아니에요.
  • 정확한 심볼 이름이나 경로를 알면 rg나 직접 읽기로 충분해요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기