grepai

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 161 🐛 待处理 18 👀 关注 12

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1937

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，100%本地运行

项目预览

项目数据

分类搜索知识

开发团队yoanbernabeu

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

GitHubhttps://github.com/yoanbernabeu/grepai

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言C

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

GitHub 星标★ 1937

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

代码更新2026-11-02

仓库体积7.2 MB

本站数据更新2026-11-03

维护状态活跃

收录时间2026-09-12

浏览次数2

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 1937

技术标签

ai claude-code cli code-search cursor

使用教程

难度：入门约 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"
```