repobrain

给代码库装上ChatGPT，问一句就能找到答案

RepoBrain（原名Antigravity）是一个为代码库提供智能问答与搜索能力的开源工具，旨在让开发者通过自然语言与整个代码仓库交互。它解决了大型代码库中代码定位、理解与维护效率低下的问题，核心能力包括基于语义的代码搜索、上下文感知的代码问答、跨文件依赖分析等。它支持与Claude Code、Cursor、Codex、Windsurf等主流AI编程助手集成，可作为这些工具的插件或独立CLI使用。项目基于Python开发，利用agents-sdk构建智能体，能够理解项目结构并精准回答关于代码的问题，帮助开发者快速上手新项目、定位Bug、理解复杂逻辑。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1328

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队study8677

所属国家

官网地址https://deepwiki.com/study8677/antigravity-workspace-template

GitHubhttps://github.com/study8677/repobrain

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agents-sdk,ai-agent,claude-code,code-intelligence,code-search,codebase-qa,codex-cli,copilot,cursor,developer-tools,ide-plugin,knowledge-graph,llm,mcp,mcp-server,multi-agent,openai,python,rag,windsurf

GitHub 星标★ 1328

30天Star增速

HF 下载量

上线时间2025-11-19 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

已安装并登录的 AI 编程工具：Claude Code 或 Codex CLI（推荐），Cursor / Trae / Windsurf 等亦可
Python 环境，pip 与 pipx 可用（手动安装或 Codex 安装时需要）
如需使用托管模型，准备 OpenAI / DeepSeek / Groq / 阿里灵积 / NVIDIA NIM 等 OpenAI 兼容 API Key（可选，
Git（用于拉取仓库形式的安装包）

安装与启动步骤

1插件市场安装

在 Claude Code 中先添加 marketplace，再安装 repobrain 插件；首次会话会自动装好 rb CLI 与引擎。
```
/plugin marketplace add study8677/repobrain
/plugin install repobrain@repobrain
```
2首次配置后端

每个项目运行一次。交互式选择已登录的本地 CLI（免密钥）或 API Key 提供商，并写入 .env。
```
/repobrain:rb-setup
```
3构建知识库

为当前代码库建立语义索引，rb-ask 的问答质量依赖这一步的完成结果。
```
/repobrain:rb-refresh
```
4提问代码问题

用自然语言提问，答案基于真实代码并附带文件路径与行号。
```
/repobrain:rb-ask "How does auth work?"
```

5Codex CLI 安装

Codex 需手动装引擎与 CLI，再添加插件市场；命令不加 repobrain: 前缀。

pipx install "git+https://github.com/study8677/repobrain.git#subdirectory=engine"
pipx inject --force --include-apps repobrain-engine "git+https://github.com/study8677/repobrain.git#subdirectory=cli"
codex plugin marketplace add study8677/repobrain

6手动 pip 安装

不使用插件时的备选方案，分别从 cli 与 engine 两个子目录安装。

pip install "git+https://github.com/study8677/repobrain.git#subdirectory=cli"
pip install "git+https://github.com/study8677/repobrain.git#subdirectory=engine"

7让 AI 代安装

已在登录状态的 AI IDE 中，把这一行贴给助手，它会自动检测 CLI、配置零密钥后端并自测。
```
Read https://github.com/study8677/repobrain/blob/main/AI_INSTALL.md and follow it to install RepoBrain in this project.
```

关键配置

配置项	必填	说明	示例
`RB_HOST_RUNNER`	否	启用本地 CLI 作为后端运行器，免 API Key	`codex`
`RB_HOST_COMMAND`	否	指定实际调用的本地 CLI 命令	`codex exec`
`OPENAI_BASE_URL`	否	使用托管模型时的 OpenAI 兼容接口地址	`https://api.openai.com/v1`
`OPENAI_API_KEY`	否	托管模型提供商的 API 密钥	`sk-xxxxxxxx`
`OPENAI_MODEL`	否	问答与索引所使用的模型名称	`gpt-5.5`

如何确认成功

运行 /repobrain:rb-ask "How does auth work?"，若能返回带文件路径与行号的真实代码答案即成功。

常见问题

Q：没有 API Key 可以用吗？

A：可以。rb-setup 会检测你已登录的本地 CLI（Codex / Trae / Claude / Gemini），提供免密钥的本地 host-runner，直接复用现有登录驱动问答与索引。

Q：Codex CLI 里要加 repobrain: 前缀吗？

A：不用。Codex 会自动发现插件 commands/ 目录下的斜杠命令，同样四条命令直接可用；原生调用 rb-refresh --workspace . 与 rb-ask "..." --workspace . 也仍可用。

Q：每个项目都要重新配置吗？

A：rb-setup 每个项目运行一次即可；如果项目根目录已有可用的 .env，可以跳过这一步，直接执行 rb-refresh。

Q：Codex 支持 MCP 怎么办？

A：如果你的 Codex 版本支持 MCP，可以单独注册 rb-mcp --workspace ；Codex hooks 目前尚不支持。

注意事项

rb-setup 会把 .env 写到项目根目录并自动加入 .gitignore，注意不要把密钥提交进仓库。
手动安装需要分别安装 cli 与 engine 两个子目录包，缺一不可。
Codex CLI 的 hooks 尚未支持，必须手动安装引擎后才能使用。
首次构建知识库需等 rb-refresh 跑完，索引未完成时问答结果可能不完整。

核心亮点

深度集成主流AI编程工具，如Claude Code、Cursor，无需切换环境
语义级代码搜索，超越关键词匹配，能理解意图
支持跨文件依赖分析，回答问题时自动关联相关代码

不足之处

文档/社区待观察
项目尚在成长中，稳定性和API可能变化

适用场景

新成员快速理解大型遗留代码库
开发中快速定位Bug根因
代码评审时自动生成解释文档

替代项目

Sourcegraph Cody、Continue.dev、Cursor

项目介绍

repobrain 是智能体领域的开源项目，由 study8677 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,328）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,299 增加到 1,328，净增 29。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。

它主要面向的使用场景是：新成员快速理解大型遗留代码库。同类可对比的替代方案包括 Sourcegraph Cody、Continue.dev、Cursor。

上一篇：auto-re-agent

下一篇：open-science