grepai

让 AI 代理本地语义搜代码、看调用关系，不传云端

grepai 是一个面向 AI 编程代理的本地语义搜索与调用图工具，用 C 语言编写，主打 100% 本地运行、隐私优先。它解决的核心问题是：传统 grep 只能做字面匹配，AI 代理在大型代码库里难以快速找到语义相关的代码片段和函数调用关系。grepai 通过本地嵌入模型建立向量索引，让 Claude Code、Cursor 等代理能用自然语言检索代码，同时构建调用图帮助理解函数之间的依赖与引用。它提供 CLI 和 MCP 接口，可直接接入现有 AI 编码工作流，无需把代码上传到云端，适合对代码隐私敏感、又希望提升 AI 代理检索效率的团队和个人开发者。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1873

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队yoanbernabeu

所属国家

官网地址https://yoanbernabeu.github.io/grepai

GitHubhttps://github.com/yoanbernabeu/grepai

定价模式free

价格说明开源免费，100%本地运行

访问状态

是否开源是

开源协议MIT

主要语言C

技术栈/模型ai,claude-code,cli,code-search,cursor,developer-tools,embeddings,golang,mcp,privacy-first,semantic-search,vector-search

GitHub 星标★ 1873

30天Star增速

HF 下载量

上线时间2026-01-09 00:00:00

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数1

使用教程

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

环境要求

macOS / Linux / Windows 系统（提供对应安装方式）
需要一个嵌入提供方：Ollama（默认推荐）、LM Studio 或 OpenAI
使用 Ollama 时需拉取 nomic-embed-text 模型
安装脚本需联网从 GitHub 下载二进制

安装与启动步骤

1macOS 用 Homebrew 安装

macOS 用户可通过官方 tap 安装 grepai，安装完成后 grepai 命令即可全局使用。
```
brew install yoanbernabeu/tap/grepai
```
2Linux/macOS 脚本安装

非 Homebrew 环境的 Linux 或 macOS，用官方 install.sh 一键安装。
```
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh
```
3Windows 脚本安装

Windows 用户在 PowerShell 中执行官方 install.ps1 完成安装。
```
irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex
```
4拉取嵌入模型

默认使用 Ollama 作为嵌入提供方，先拉取 nomic-embed-text 模型，用于生成本地向量索引。
```
ollama pull nomic-embed-text
```
5初始化项目

在代码项目目录下执行，为该仓库建立 grepai 的索引与配置。
```
grepai init
```
6启动索引守护

开启 watch 守护进程，文件变动时索引自动刷新，保持检索结果最新。
```
grepai watch
```
7语义搜索代码

用自然语言描述意图进行语义检索，而不是只匹配字面文本。
```
grepai search "error handling"
```
8追踪函数调用方

查看某个函数被谁调用，改动前先确认影响范围。
```
grepai trace callers "Login"
```

如何确认成功

grepai watch 启动后索引守护正常运行，再执行 grepai search "error handling" 能返回语义相关代码结果即为成功。

常见问题

Q：代码会被上传到云端吗？

A：不会。grepai 主打 100% 本地运行，向量索引和嵌入都在本机完成，代码不离开你的机器。

Q：一定要装 Ollama 吗？

A：不一定。README 说明需要嵌入提供方，可选 Ollama（默认推荐）、LM Studio 或 OpenAI。

Q：能接入哪些 AI 编程代理？

A：Claude Code、Cursor、Windsurf 可开箱即用；grepai 还提供 MCP server，代理可直接把 grepai 当工具调用。

Q：索引会不会过期？

A：不会。grepai watch 会监听文件变化，自动保持索引为最新状态。

注意事项

需先准备嵌入提供方（默认 Ollama）并拉取 nomic-embed-text，否则无法建立向量索引。
README 未给出自定义配置文件项，具体参数请查阅官方文档站点 https://yoanbernabeu.github.io/grepai/。
grepai init 与 grepai watch 需在目标代码项目目录下执行。

核心亮点

100% 本地运行，代码不出本机，适合隐私敏感场景
同时提供语义向量搜索和调用图，比纯 grep 更懂代码意图
支持 MCP 协议，可直接接入 Claude Code、Cursor 等主流 AI 代理

不足之处

用 C 语言实现，构建和二次开发门槛相对较高
项目仍处成长阶段，生态集成和文档完善度待观察

适用场景

在大型代码库中让 AI 代理用自然语言定位相关实现
分析函数调用链，辅助重构或排查影响范围
为本地 AI 编码助手提供不联网的代码检索能力

替代项目

Sourcegraph、ripgrep

项目介绍

grepai 是一个搜索知识领域的开源项目，官方简介：Semantic Search & Call Graphs for AI Agents (100% Local)。项目使用 C 开发，在 GitHub 上获得 1860 星标。

上一篇：last30days-skill

下一篇：GPT-RAG