repobrain — Claude Code plugin: codebase knowledge and setup
repobrain builds a knowledge base for a repository and answers code questions with file and line references. Use it to explore an unfamiliar project or trace how its modules connect.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install repobrain@awesome-codex-pluginsWhat repobrain does
The plugin creates a .repobrain/ directory in the project and stores knowledge about its modules there. rb-refresh has agents inspect the code and produce module notes. rb-ask routes a question to relevant context and returns an answer tied to source files and lines. Supported IDEs share the same knowledge base.
You need Python 3.10+, Git with at least one commit, and a configured model backend. The worktree must be clean before a refresh, so commit or stash local changes first. Initial builds can take several minutes or longer on large repositories. The plugin is available for Claude Code and Codex; Claude Code commands cover setup, refresh, and asking questions.
What it helps with
- explore an unfamiliar repository
- locate an API implementation and its callers
- trace data flow from the UI to the backend
- identify modules affected by a function change
- update module notes after committed changes
Example prompts for the agent
- Set up repobrain for this project with
/rb-setup. - Build the project knowledge base with
/rb-refresh. - Use
/rb-askto explain how authentication works in this project.
How to install repobrain
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install repobrain@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about repobrain
How do I install repobrain in Claude Code?
Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install repobrain@awesome-codex-plugins.
What does repobrain do?
It builds module-level knowledge for a codebase and answers questions about the code with references to source files and lines.
What does repobrain need to run?
It requires Python 3.10+, Git with at least one commit, and a configured model backend. The worktree must be clean before refreshing the knowledge base.
Source text
antigravity-workspace-template · MIT
<div align="center">
<img src="docs/assets/logo.svg" alt="RepoBrain" width="140"/>
# RepoBrain
Cross-IDE repository knowledge engine for grounded codebase Q&A.
<sub>Formerly known as <b>Antigravity Workspace Template</b> — same project, new name.</sub>
**English** · [中文](README_CN.md) · [Español](README_ES.md)
[](LICENSE)
[](https://python.org/)
[](https://github.com/study8677/repobrain/actions)
[](https://deepwiki.com/study8677/repobrain)
[](https://github.com/xiaolai/nlpm-for-claude)
[](https://github.com/study8677/repobrain/stargazers)
<img src="docs/assets/demo.gif" alt="rb-ask demo — ask your codebase, get grounded answers with file paths and line numbers" width="800"/>
</div>
<div align="center">
<p><strong>🚀 实测推荐:</strong> <a href="https://teamorouter.com/?i=e188641773">TeamoRouter</a> —— 非广告,我自己在 Codex、Claude Code 等 AI 编程工具里高强度使用:一个 API Key 接入 Claude、GPT-5.5 等,模型价格方便调整,价格优惠,并没有掺水的情况。接入指南见 <a href="https://github.com/xixiaoyao/openrouter-api-key">openrouter-api-key</a>。</p>
</div>
RepoBrain helps you understand an unfamiliar repository, trace an implementation,
and ask questions with source-file references. It keeps project knowledge in
`.repobrain/`, shared across supported IDEs and agents.
## Project Philosophy
**Cross-IDE repository knowledge engine for grounded codebase Q&A.** Same `.repobrain/` knowledge layer reads in every IDE; one engine, every host.
> An AI Agent's capability ceiling = **the quality of context it can read.**
`rb-refresh` deploys a multi-agent cluster that autonomously reads your code — each module gets its own Agent that generates a knowledge doc. `rb-ask` routes questions to the right Agent, grounded in real code with file paths and line numbers.
**Instead of handing Claude Code / Codex a repo-wide `grep` and making it hunt on its own, give it a ChatGPT for your repository.**
```
Traditional approach: RepoBrain approach:
CLAUDE.md = 5000 lines of docs Claude Code calls ask_project("how does auth work?")
Agent reads it all, forgets most Router → ModuleAgent reads actual source, returns exact answer
Hallucination rate stays high Grounded in real code, file paths, and git history
```
<details>
<summary><b>Four concrete failure modes RepoBrain fixes</b> — click to expand</summary>
| Problem | Without RepoBrain | With RepoBrain |
|:--------|:-------------------|:-----------------|
| Agent forgets coding style | Repeats the same corrections | Reads `.repobrain/conventions.md` — gets it right the first time |
| Onboarding a new codebase | Agent guesses at architecture | `rb-refresh` → ModuleAgents self-learn each module |
| Switching between IDEs | Different rules everywhere | One `.repobrain/` folder — every IDE reads it |
| Asking "how does X work?" | Agent reads random files | `ask_project` MCP → Router routes to the responsible ModuleAgent |
Architecture is **files + a live Q&A engine**, not plugins. Portable across any IDE, any LLM, zero vendor lock-in.
</details>
Read the full [project philosophy](docs/en/PHILOSOPHY.md).
## Quick Start
Ask an AI assistant that can run commands in your project to install RepoBrain:
> Read [AI_INSTALL.md](https://github.com/study8677/repobrain/blob/main/AI_INSTALL.md) and follow it to install RepoBrain in this project.
The guide installs the tools, configures a model backend, then builds the knowledge
base and checks an answer. A logged-in headless CLI such as Trae can serve as the
backend without an API key; an OpenAI-compatible API is also supported. Requirements:
Python 3.10+, Git with at least one commit, and a clean worktree before refresh.
For platform-specific installation or manual configuration, see
[the installation guide](INSTALL.md) and [the quick-start guide](docs/en/QUICK_START.md).
Installing RepoBrain into an existing project does not require `rb init` or `rb-init`.
## Everyday Use
Run these commands in your project directory after installation and configuration:
```bash
rb-refresh
rb-ask "How does authentication work in this project?"
```
`rb-refresh` automatically builds the first knowledge base, updates affected groups
after committed changes, or continues a matching interrupted task. If knowledge is
already current, it skips without calling a model. After a failure, run the same
command again to continue.
Use this only when you want to regenerate all knowledge:
```bash
rb-refresh --full
```
`rb-ask` reads the existing knowledge base and answers with source evidence. It
reminds you when committed code is newer; it does not refresh during a question.
Examples of useful questions:
- Where is this API implemented, and what calls it?
- How does data move from the UI to the backend?
- Which modules are affected by changing this function?
## How It Works
```text
Source code → rb-refresh → .repobrain/ knowledge → rb-ask → answer with code references
```
RepoBrain groups related code, generates module knowledge, and routes each question
to relevant context. Knowledge lives in your project, so supported IDEs share the
same base. Updates are staged separately and become active only when complete;
a failed update preserves the existing usable generation.
The first build can take several minutes or longer on large repositories and
uses your configured model. Commit or stash local changes before refreshing.
IDE rules and new-project scaffolding are optional; see [the usage reference](docs/en/USAGE.md).
## Support Matrix
| Use | Environments | How to connect |
|:----|:-------------|:---------------|
| Native plugins | Claude Code, Codex CLI | Setup, refresh, and ask via slash commands. |
| Compatible IDEs | Cursor, Windsurf, Gemini CLI, VS Code + Copilot, Cline, Aider, DeepSeek Harness | Shared context files, CLI, or an MCP client. |
| Other agents and scripts | Any host that can run commands or call MCP tools | CLI/JSON output or optional `rb-mcp`. |
Platform-specific commands, JSON output, and MCP registration are documented in
[the usage reference](docs/en/USAGE.md) and [INSTALL.md](INSTALL.md).
## Evaluation
A locked comparison on Flask, ripgrep, Vite, and Prometheus used the same source
access and model route for RepoBrain and CodeGraph + Trae. The
[full report](benchmarks/codegraph-comparison/results/latest-v2-full-report.md)
includes accuracy, query time, tokens, and cold-build cost. Results apply to that
experiment; AI knowledge generation and static graph indexing are different workloads.
## Documentation
- [Installation and troubleshooting](INSTALL.md)
- [Commands, JSON, and optional integrations](docs/en/USAGE.md)
- [Knowledge generation and Q&A architecture](docs/en/SWARM_PROTOCOL.md)
- [External MCP tools](docs/en/MCP_INTEGRATION.md) · [Sandbox configuration](docs/en/SANDBOX.md)
- [Release changes](CHANGELOG.md)
- Full documentation: [English](docs/en/README.md) · [中文](docs/zh/README.md) · [Español](docs/es/README.md)
**NLPM Audit Feedback** — Improved by [NLPM](https://github.com/xiaolai/nlpm-for-claude), a natural-language programming linter by [xiaolai](https://github.com/xiaolai).
---
## Contributing
Ideas are contributions too! Open an [issue](https://github.com/study8677/repobrain/issues) to report bugs, suggest features, or propose architecture.
## Contributors
<table>
<tr>
<td align="center" width="20%">
<a href="https://github.com/Lling0000">
<img src="https://github.com/Lling0000.png" width="80" /><br/>
<b>⭐ Lling0000</b>
</a><br/>
<sub><b>Major Contributor</b> · Creative suggestions · Project administrator · Project ideation & feedback</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/h13181278389">
<img src="https://github.com/h13181278389.png" width="80" /><br/>
<b>h13181278389</b>
</a><br/>
<sub><b>Core Contributor</b> · Thank you for your support, feedback, and contributions to RepoBrain</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/flyw1015">
<img src="https://github.com/flyw1015.png" width="80" /><br/>
<b>flyw1015</b>
</a><br/>
<sub><b>Core Contributor</b> · Thank you for your support, feedback, and contributions to RepoBrain</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/devalexanderdaza">
<img src="https://github.com/devalexanderdaza.png" width="80" /><br/>
<b>Alexander Daza</b>
</a><br/>
<sub>Sandbox MVP · OpenSpec workflows · Technical analysis docs · PHILOSOPHY</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/chenyi">
<img src="https://github.com/chenyi.png" width="80" /><br/>
<b>Chen Yi</b>
</a><br/>
<sub>First CLI prototype · 753-line refactor · DummyClient extraction · Quick-start docs</sub>
</td>
</tr>
<tr>
<td align="center" width="20%">
<a href="https://github.com/Subham-KRLX">
<img src="https://github.com/Subham-KRLX.png" width="80" /><br/>
<b>Subham Sangwan</b>
</a><br/>
<sub>Dynamic tool & context loading (#4) · Multi-agent swarm protocol (#3)</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/shuofengzhang">
<img src="https://github.com/shuofengzhang.png" width="80" /><br/>
<b>shuofengzhang</b>
</a><br/>
<sub>Memory context window fix · MCP shutdown graceful handling (#28)</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/goodmorning10">
<img src="https://github.com/goodmorning10.png" width="80" /><br/>
<b>goodmorning10</b>
</a><br/>
<sub>Enhanced <code>rb ask</code> context loading — added CONTEXT.md, AGENTS.md, and memory/*.md as context sources (#29)</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/abhigyanpatwari">
<img src="https://github.com/abhigyanpatwari.png" width="80" /><br/>
<b>Abhigyan Patwari</b>
</a><br/>
<sub>Code knowledge graph integration for <code>rb ask</code> — symbol search, call graphs, and impact analysis</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/BBear0115">
<img src="https://github.com/BBear0115.png" width="80" /><br/>
<b>BBear0115</b>
</a><br/>
<sub>Skill packaging & KG retrieval enhancements · Multi-language README sync (#30)</sub>
</td>
</tr>
<tr>
<td align="center" width="20%">
<a href="https://github.com/SunkenCost">
<img src="https://github.com/SunkenCost.png" width="80" /><br/>
<b>SunkenCost</b>
</a><br/>
<sub><code>rb clean</code> command · <code>__main__</code> entry-point guard (#37)</sub>
</td>
<td align="center" width="20%">
<a href="https://github.com/aravindhbalaji04">
<img src="https://github.com/aravindhbalaji04.png" width="80" /><br/>
<b>Aravindh Balaji</b>
</a><br/>
<sub>Unified instruction surface around <code>AGENTS.md</code> (#41)</sub>
</td>
</tr>
<tr>
<td align="center" width="20%">
<a href="https://github.com/xiaolai">
<img src="https://github.com/xiaolai.png" width="80" /><br/>
<b>xiaolai</b>
</a><br/>
<sub><a href="https://github.com/xiaolai/nlpm-for-claude">NLPM</a> audit feedback · Skill frontmatter fixes · Dependency hygiene review (#51, #52, #53)</sub>
</td>
</tr>
</table>
## Star History
[](https://star-history.com/#study8677/repobrain&Date)
## License
MIT License. See [LICENSE](LICENSE) for details.
---
<div align="center">
**[📚 Full Documentation →](docs/en/)**
*Built for the AI-native development era*
Friendly Link: [LINUX DO](https://linux.do/)
</div>
© hashgraph-online · MIT · hashgraph-online/awesome-codex-plugins