XERJ: 에이전트가 grep 대신 쓰는 로컬 검색 엔진
grep으로 파일을 통째로 읽던 코딩 에이전트가 XERJ로 구절만 받아, 같은 16/16 해결에 출력 토큰을 2.7배 줄였어요
- 누가
- 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이 대표 쓰임새예요.
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
이걸로 만든 사람들
과학 계산용 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.
Windows x64에서 autoindex, 키워드 검색, 정의 찾기를 직접 돌려 보고 그 결과를 필드 리포트로 남겼어요.
This report describes a small Windows x64 trial of autoindex, lexical search, and definition lookup
안에서는 이렇게 돌아가요
- 1
나 → Claude Code
한 줄 설치 프롬프트 (llms.txt)README의 프롬프트를 붙이면 에이전트가 llms.txt의 순서대로 설치, 실행, 색인을 진행해요.landing/llms.txt - 2
Claude Code → xerj 노드 (localhost:9200)
curl -fsSL https://xerj.org/get | shOS와 CPU에 맞는 릴리스 바이너리를 받아 SHA-256을 확인하고 설치한 뒤 노드를 띄워요.landing/get - 3
Claude Code → xerj mcp
xerj init → .mcp.json설치된 에이전트를 찾아 MCP 서버를 등록하고, 손대는 파일은 .bak으로 백업해요.engine/crates/xerj-autoindex/src/init.rs - 4
xerj autoindex → xerj 노드 (localhost:9200)
xerj autoindex ~/my-project확장자를 믿지 않고 매직 바이트와 내용으로 형식을 판별해 데이터셋마다 인덱스를 만들어요.engine/crates/xerj-autoindex/src/sniff.rs - 5
xerj autoindex → xerj 노드 (localhost:9200)
코드 → 심볼 {name, kind, line}소스는 tree-sitter로 파싱해 함수, 클래스 같은 정의마다 문서를 따로 만들어요.engine/crates/xerj-autoindex/src/extract/code.rs - 6
Claude Code → xerj mcp
xerj_search · xerj_def 호출MCP 도구 호출이 노드에 보내는 검색 요청으로 바뀌어요.engine/crates/xerj-mcp/src/lib.rs - 7
xerj mcp → file:line이 붙은 구절
정의 위치 file:line + 시그니처xerj_def는 CLI의 xerj def와 같은 질의로 정의를 찾아 돌려줘요.engine/crates/xerj-mcp/src/def.rs
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 비공개, 사내, 덜 알려진 코드를 에이전트에게 맡길 때
- 에이전트가 grep과 파일 읽기로 토큰을 많이 쓸 때
- 로그, CSV, PDF, 메일이 섞인 폴더를 질문으로 뒤지고 싶을 때
- 이미 Elasticsearch 클라이언트나 대시보드를 쓰고 있을 때
이건 안 돼요
- README 기준, 효과는 모델이 외우지 못한 코드에서 나요. 모델이 이미 아는 인기 공개 라이브러리에선 차이가 없거나 오히려 손해일 수 있어요.
- --insecure로 띄우면 TLS와 인증이 꺼져 포트에 닿는 누구나 모든 인덱스를 읽고 지울 수 있어요. 혼자 쓰는 개발 PC용이에요.
- 엔진 소스는 Apache-2.0이지만 rc.101부터 릴리스 바이너리에 든 XERJ Query-1 크레이트는 독점이에요. Query-1 모델은 기본으로 꺼져 있어요.
- MCP 클라이언트 26개 가운데 실제로 등록해 시험한 건 Claude Code를 포함한 6개예요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요