Picture published by the creator on GitHub.
XERJ: Let your coding assistant search your files instead of reading them all
Added · Updated
Made by xerj-org
View profile on GitHub (opens in a new tab)Let an AI coding assistant search your code, docs, logs and PDFs locally for the exact passage it needs.
For developers who use coding assistants.
What it does
XERJ is a search engine that runs on your own machine as one Rust program. It reads (indexes) folders of code, docs, logs, JSONL or CSV files and PDFs, and supports keyword search (BM25), meaning-based vector search, and a mix of both. It speaks the same API as Elasticsearch, a widely used search server. Through MCP (a way to plug tools into an AI assistant), an assistant asks XERJ for the right passage instead of opening whole files one by one. The creators report a controlled study where this cut a coding agent's output tokens by 2.7x at the same solve rate.
How to use it
Input → action → output: start the XERJ server, connect it to Claude Code or Cursor, and point it at a project folder. When you or your assistant ask a question like where a function is defined, it returns ranked passages with file and line locations.
Common use cases
- Index your project folder and ask your coding assistant how a feature works; it pulls the matching code passages with file and line numbers.
- Have your assistant download and index open source repos similar to your task, then search how they solved the same problem before writing code.
- Store notes in an agent memory index so your assistant can search earlier decisions in later sessions.
Can I use this?
Requirements Install the binary with the creators' install script or by hand, start it with a data directory kept outside any folder you will index, then run xerj init to connect it to Claude Code or Cursor. Licensed Apache-2.0. The creators ask users to send back one short field report.
Caveat Keep the server on your own machine in dev mode; it binds only to 127.0.0.1 by default and refuses other cleartext binds unless you allow them.
Worth knowing The insecure dev mode turns off TLS and API key auth, so anyone who can reach the port can read and delete every index. Token savings are the creators' own measurements.
Why it's here
Not trending this week
Last seen on the GitHub trending list on 31 October 2026. It stays on BuildTube so you can still find it.
- 18,612 people have starred it on GitHub.
Numbers checked on 8 November 2026; not refreshed since.
Behind it
View setup guideBuildTube has not run or verified this project. Everything above is written from what the creator published.
Made this?
Quick questions
- What is XERJ?
- XERJ is a search engine that runs on your own machine as one Rust program.
- What can I use XERJ for?
- Index your project folder and ask your coding assistant how a feature works; it pulls the matching code passages with file and line numbers; Have your assistant download and index open source repos similar to your task, then search how they solved the same problem before writing code; Store notes in an agent memory index so your assistant can search earlier decisions in later sessions
- Can I run XERJ on my computer?
- It runs from a terminal on your own computer.
- What do I need to use XERJ?
- A computer that can run the single Rust binary; Windows install steps are separate. An MCP client such as Claude Code or Cursor to connect it to an assistant.
- What license does XERJ use?
- Licensed Apache-2.0.
More from this week
- agent-desktop Let AI agents read and click desktop apps
For developers building computer-use agents: agent-desktop lets an AI agent read and operate desktop apps on Mac, Windows or Linux from a command line.
- Stroq Check AI coding agent sessions for leaked keys
Stroq scans your recent Claude Code and Codex sessions for keys that left your machine.
- DeepTutor Study your own documents with a personal AI tutor
Read documents with page-by-page citations, practice daily and get video lessons from an AI tutor.
Explore by topic
Post this
Download share imageFor makers
Made this? Show it’s on BuildTube — add the badge to your README or embed the card on your site.
README badge (Markdown)
[](https://buildtube.app/p/gh-xerj-org-xerj/)Embed card (HTML)
<iframe src="https://buildtube.app/embed/gh-xerj-org-xerj/" width="560" height="240" style="border:0;max-width:100%" loading="lazy" title="XERJ on BuildTube"></iframe>