xerj
XERJ is a local search engine packaged as a single static Rust binary with no JVM. Running xerj autoindex on a folder sniffs every file and creates typed indices for code, docs, logs, PDFs, SQLite and CSV, with code indexed by symbol and line number through tree-sitter. Queries go through an Elasticsearch-compatible API with BM25, kNN vector and hybrid search, so existing ES clients work unchanged.
Its headline use is reference coding: the agent clones open-source repos close to the task, indexes them, and retrieves how they solved the problem before writing code. The project's own case study (8 tasks, 16 runs per arm) reports 2.7x fewer output tokens than a grep-driven agent at the same 16/16 solve rate, and it states openly that the gain disappears on popular libraries the model already knows.
xerj init wires it into Claude Code or Cursor as an MCP server plus skill, and a /_memory API gives agents long-term memory. The default embedder is lexical and offline; neural embeddings are opt-in (about 90 MB). The quick-start runs with --insecure, meaning no TLS or auth, which is only appropriate on a single-user dev machine. License is Apache-2.0.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-10-20
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 30
- Latest release
- pack-rust-vulns-96115c19 (2026-10-20)
- Open issues
- 98
- Recent issues with at least one comment
- 13/30
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #1122 engine: node dies SIGABRT under memory exhaustion — std thread-spawn sigaltstack panic hits panic="abort"8 comments · 2026-10-03
- #1138 Community contribution: two eval/retrieval recipes from production agent-memory scars (corpus wishlist included)6 comments · 2026-10-04
- #1635 [bug]: autoindex at default workers stalls at 70.9% and the node stops answering searches (13,765 files / 1,153 MB)4 comments · 2026-10-17
- #1979 Agent field report (API): Claude Code (claude-opus-5-5) — reference coding + autoindex of a private multi-repo workspace2 comments · 2026-10-20
- #1957 Agent field report (API): deepseek-v4-1-flash-260910 — installed XERJ on Windows, indexed an Android Compose/Kotlin pill-reminder project (12 comments · 2026-10-20
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!