xerj
SHA-256XERJ는 로컬 AI 검색 엔진으로, 명령어 하나로 어떤 폴더든 자동으로 인덱싱하여 프로그래밍 에이전트가 코드 스니펫을 정확하게 검색할 수 있게 해주며, grep 대비 토큰을 2.7배 절약합니다.
AI가 명령어 하나로 당신의 데이터를 이해하게 하세요. 검색은 정확하고 Token도 절약됩니다
주요 기능
- 단일 명령어로 코드, 문서, 로그, PDF, SQLite, CSV 등 다양한 파일을 자동 인덱싱
- Elasticsearch API와 호환되어 기존 클라이언트를 즉시 사용 가능
- 하이브리드 검색: BM25 키워드 + kNN 벡터 + 시맨틱 순위 지정
- 내장 Agent 장기 메모리, 세션 간 의미 기반 리콜
- 단일 파일 정적 바이너리, Rust로 작성, JVM이나 외부 서비스 불필요
할 수 없는 것
- •-insecure 모드는 TLS 암호화와 인증을 해제하므로, 해당 포트에 접근할 수 있는 모든 프로그램이 최고 권한을 가지며 모든 인덱스를 읽고 쓰거나 심지어 삭제할 수 있습니다. 따라서 로컬 단독 개발 용도로만 사용해야 하며, LAN이나 공용 네트워크 주소에 바인딩해서는 안 됩니다. 둘째, 모델이 이미 잘 알고 있는 인기 오픈소스 라이브러리에서는 효과가 제한적이며, Token을 실질적으로 절약할 수 있는 시나리오는 비공개 코드, 내부 시스템, 잘 알려지지 않은 프로젝트입니다. 또한 기본 어휘 임베딩은 오프라인에서 사용할 수 있지만, 뉴럴 임베딩을 활성화하려면 약 90MB의 모델 파일을 추가로 다운로드해야 합니다.
사용 사례
- 참조 코딩: 유사한 오픈소스 프로젝트를 인덱싱하여 코드 작성 전 기존 구현 방안을 먼저 검색
- 코드베이스 Q&A 및 RAG: 전체 파일 대신 줄 번호가 포함된 코드 조각을 직접 반환
- 보안 감사: 모든 파일 유형에 걸쳐 위험한 호출, 키 및 민감한 패턴을 검색
- 로그 및 장애 분석: 혼합 형식의 로그를 집계 가능한 구조화된 인덱스로 자동 변환
- Agent 장기 기억: 학습한 경험을 메모리 공간에 저장하고 다음 세션에서 의미 기반으로 회상
XERJ는 프로그래밍 Agent를 위해 설계된 로컬 AI 검색 백엔드입니다. autoindex 명령 하나로 코드, 문서, 로그, PDF, SQLite, 심지어 형식이 엉망인 CSV까지 모든 폴더를 자동으로 스캔하여 검색, RAG, 보안 감사, Agent 장기 메모리에 활용할 수 있는 쿼리 가능한 인덱스를 생성합니다. 실제 테스트에 따르면, XERJ로 참조 코딩(유사한 오픈소스 프로젝트를 먼저 인덱싱하고 기존 솔루션을 검색한 후 코드를 작성)을 수행하는 Agent는 출력 Token이 grep 방식보다 2.7배, 순수 메모리 방식보다 26배 적으면서도 작업 완료율은 동일했습니다. Elasticsearch를 직접 배포하는 것과 비교하면, XERJ는 JVM이 필요 없는 단일 Rust 정적 바이너리이면서도 ES 인터페이스 호환성을 유지하며(1366/1369 일관성 테스트 통과), 기존 클라이언트를 바로 사용할 수 있습니다. BM25 + 벡터 하이브리드 검색, tree-sitter 기반 코드 심볼 위치 지정(파일과 라인 번호까지 정확히), 기본 오프라인 어휘 임베딩, 네이티브 MCP 지원, 그리고 /_memory 메모리 공간을 제공합니다. 모델이 기존 지식을 갖고 있지 않은 프라이빗, 내부 또는 비주류 코드베이스와 같은 시나리오에 가장 적합합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
curl -fsSL https://xerj.org/get | sh를 실행하여 단일 파일 프로그램 설치
xerj --insecure --data-dir ./data &를 실행하여 로컬 서비스 시작 (로컬 단일 사용자 전용)
xerj init를 실행하여 Claude Code 또는 Cursor에 한 번에 연결
- curl -fsSL https://xerj.org/get | sh를 실행하여 단일 파일 프로그램 설치
- xerj --insecure --data-dir ./data &를 실행하여 로컬 서비스 시작 (로컬 단일 사용자 전용)
- xerj init를 실행하여 Claude Code 또는 Cursor에 한 번에 연결
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
557d1f5dc9fbb151035d0e4b5e2da3032f8c3224f54fe235055c1cc70eced25b이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
xerj 바이너리 파일(일반적으로 ~/.local/bin 또는 /usr/local/bin에 위치함)을 삭제한 다음, 시작 시 --data-dir로 지정한 데이터 디렉터리를 삭제하세요. xerj init을 실행한 경우에는 Claude Code 또는 Cursor의 MCP 설정에서 xerj 관련 항목도 제거해야 합니다. 백그라운드 데몬이나 시스템 서비스가 남지 않으므로 이것으로 정리가 완료됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs