AI 칼럼

데이터@donghyeok99운영진

XERJ: 에이전트가 grep 대신 쓰는 로컬 검색 엔진

grep으로 파일을 통째로 읽던 코딩 에이전트가 XERJ로 구절만 받아, 같은 16/16 해결에 출력 토큰을 2.7배 줄였어요

xerj autoindex가 코드, PDF, CSV, 로그를 종류별 인덱스로 나누고 xerj search 한 번에 file:line 구절 하나가 나와요. 아래 막대는 README의 출력 토큰 비교예요.
xerj autoindex가 코드, PDF, CSV, 로그를 종류별 인덱스로 나누고 xerj search 한 번에 file:line 구절 하나가 나와요. 아래 막대는 README의 출력 토큰 비교예요.
누가
xerj-org가 Apache-2.0으로 공개한 검색 엔진이에요. 코딩 에이전트에게 코드와 문서를 빨리 찾아 주고 싶은 개발자를 위한 거예요.
언제
2026년 6월에 공개됐어요. README 기준 최신 rc.101에서 XERJ Query-1 모델이 들어왔고, 11월 9일에도 코퍼스 팩이 올라왔어요.
어디서
Rust 바이너리 하나로 Linux, macOS, Windows에서 돌고 내 컴퓨터의 localhost:9200에 떠요. Claude Code, Cursor 같은 MCP 클라이언트에 붙어요.

이게 불편했어요

처음 보는 코드베이스를 에이전트에게 맡기면 grep으로 파일을 찾고, 찾은 파일을 통째로 읽어요. README의 측정에서는 한 코퍼스에서 입력 토큰이 106만 개까지 올라갔어요. 외우지 못한 API 앞에서는 기억에 기대다 고치기를 몇 번씩 되풀이하고요.

그래서 이렇게 풀어요

XERJ는 폴더 하나를 가리키면 파일마다 내용을 보고 형식을 알아내 데이터셋별 인덱스를 만들어요. 코드는 함수, 클래스 같은 정의와 줄 번호까지 담겨요. 에이전트는 MCP 도구로 물어보고, 파일 전체 대신 file:line이 붙은 구절만 받아요. 비슷한 오픈소스를 받아 색인한 뒤 그 풀이를 먼저 찾아보는 reference coding이 대표 쓰임새예요.

부팅, 대량 색인, 검색, 벡터 kNN, 대시보드까지 끊지 않고 보여 주는 README 데모
xerj autoindex ~/my-projectphase A: 593 datasets inferred, 1955 junk/skipped filesphase B: indexing 25329 files with 8 workersdone in 158.1s, 593 datasets, 83103 records live, 790 junk records
README의 실행 예시

이걸로 만든 사람들

GitHub@Bowen-Man2026-11-01

과학 계산용 Python 저장소 rctd-py(파일 97개)를 7.4초에, SCTransform의 CSV 26개 179,374건을 워커 4개로 33.8초에 색인했어요. 워커를 16개, 32개로 늘리면 멈추는 문제도 함께 보고했어요.

Successfully indexed 179,374 records in 33.8 seconds.
좋아요 0 · 댓글 3 (2026-11-11 기준)GitHub ↗
GitHub@GHOST-AKU2026-10-28

Windows x64에서 autoindex, 키워드 검색, 정의 찾기를 직접 돌려 보고 그 결과를 필드 리포트로 남겼어요.

This report describes a small Windows x64 trial of autoindex, lexical search, and definition lookup
좋아요 0 · 댓글 4 (2026-11-11 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code

    한 줄 설치 프롬프트 (llms.txt)README의 프롬프트를 붙이면 에이전트가 llms.txt의 순서대로 설치, 실행, 색인을 진행해요.landing/llms.txt
  2. 2

    Claude Code → xerj 노드 (localhost:9200)

    curl -fsSL https://xerj.org/get | shOS와 CPU에 맞는 릴리스 바이너리를 받아 SHA-256을 확인하고 설치한 뒤 노드를 띄워요.landing/get
  3. 3

    Claude Code → xerj mcp

    xerj init → .mcp.json설치된 에이전트를 찾아 MCP 서버를 등록하고, 손대는 파일은 .bak으로 백업해요.engine/crates/xerj-autoindex/src/init.rs
  4. 4

    xerj autoindex → xerj 노드 (localhost:9200)

    xerj autoindex ~/my-project확장자를 믿지 않고 매직 바이트와 내용으로 형식을 판별해 데이터셋마다 인덱스를 만들어요.engine/crates/xerj-autoindex/src/sniff.rs
  5. 5

    xerj autoindex → xerj 노드 (localhost:9200)

    코드 → 심볼 {name, kind, line}소스는 tree-sitter로 파싱해 함수, 클래스 같은 정의마다 문서를 따로 만들어요.engine/crates/xerj-autoindex/src/extract/code.rs
  6. 6

    Claude Code → xerj mcp

    xerj_search · xerj_def 호출MCP 도구 호출이 노드에 보내는 검색 요청으로 바뀌어요.engine/crates/xerj-mcp/src/lib.rs
  7. 7

    xerj mcp → file:line이 붙은 구절

    정의 위치 file:line + 시그니처xerj_def는 CLI의 xerj def와 같은 질의로 정의를 찾아 돌려줘요.engine/crates/xerj-mcp/src/def.rs

넣으면 이렇게 나와요

8개 과제, 4개 언어, 방식마다 16회 실행 (claude -p)출력 토큰 grep 26,477 → XERJ 9,982, 둘 다 16/16 해결 (README 사례 연구)
xerj def "euler_to_rotationmatrix"정의 위치 file:line과 시그니처
Unity 프로젝트 폴더GameObject/Component마다 레코드 하나, 「이 스크립트를 쓰는 씬은?」을 질의 한 번으로
/_memory/{namespace}에이전트가 배운 걸 저장하고 다음 세션에 의미로 불러오기

나한테 맞을까요

이럴 때 좋아요

  • 비공개, 사내, 덜 알려진 코드를 에이전트에게 맡길 때
  • 에이전트가 grep과 파일 읽기로 토큰을 많이 쓸 때
  • 로그, CSV, PDF, 메일이 섞인 폴더를 질문으로 뒤지고 싶을 때
  • 이미 Elasticsearch 클라이언트나 대시보드를 쓰고 있을 때

이건 안 돼요

  • README 기준, 효과는 모델이 외우지 못한 코드에서 나요. 모델이 이미 아는 인기 공개 라이브러리에선 차이가 없거나 오히려 손해일 수 있어요.
  • --insecure로 띄우면 TLS와 인증이 꺼져 포트에 닿는 누구나 모든 인덱스를 읽고 지울 수 있어요. 혼자 쓰는 개발 PC용이에요.
  • 엔진 소스는 Apache-2.0이지만 rc.101부터 릴리스 바이너리에 든 XERJ Query-1 크레이트는 독점이에요. Query-1 모델은 기본으로 꺼져 있어요.
  • MCP 클라이언트 26개 가운데 실제로 등록해 시험한 건 Claude Code를 포함한 6개예요.

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

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

신고하기

사유

커뮤니티 규칙 보기