yoanbernabeu/grepai

这是什么？

核心功能

• 01按意图而非精确文本进行语义搜索
• 02追踪调用图，查找某个函数的调用方
• 03可配合 Ollama、LM Studio 或 OpenAI 嵌入模型完全本地运行
• 04文件监听自动保持索引最新
• 05提供 MCP 服务，供 AI 智能体直接调用

适用场景

• 让 Claude Code 或 Cursor 无需读取整个文件即可找到相关代码
• 在不知道确切函数名时按概念定位代码
• 重构函数前查看其所有调用方
• 在不把代码发送到外部服务的前提下搜索私有代码库

快速上手

1. 1

   通过 Homebrew 安装（macOS）

   brew install yoanbernabeu/tap/grepai
2. 2

   安装嵌入模型提供方：拉取 Ollama 模型 nomic-embed-text

   ollama pull nomic-embed-text
3. 3

   在项目中初始化 grepai，然后启动索引守护进程

   grepai init && grepai watch
4. 4

   按语义搜索代码

   grepai search "error handling"

使用前须知

• !需要单独的嵌入模型提供方，如 Ollama、LM Studio 或 OpenAI。
• !Linux 和 Windows 的安装依赖 README 中的安装脚本，而非包管理器。

收录于专题

标签

常见问题

grepai 是什么？

本地运行的语义代码搜索命令行工具，支持调用图追踪，并可作为 MCP 服务供 AI 编程助手调用。 grepai 是一个命令行工具，可以按代码含义而不是精确文本来搜索代码库。它使用向量嵌入为代码建立索引，因此即使函数命名不同，输入“用户认证流程”这样的自然语言也能找到相关代码。

grepai 可以免费使用吗？用的什么许可证？

grepai 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

grepai 还在维护吗？

活跃维护中。grepai 最近一次提交是在 2026年11月2日。

grepai 适合用来做什么？

让 Claude Code 或 Cursor 无需读取整个文件即可找到相关代码 在不知道确切函数名时按概念定位代码 重构函数前查看其所有调用方 在不把代码发送到外部服务的前提下搜索私有代码库

grepai 怎么安装和运行？

通过 Homebrew 安装（macOS）: brew install yoanbernabeu/tap/grepai 安装嵌入模型提供方：拉取 Ollama 模型 nomic-embed-text: ollama pull nomic-embed-text 在项目中初始化 grepai，然后启动索引守护进程: grepai init && grepai watch 按语义搜索代码: grepai search "error handling"

在哪里获取 grepai？

源代码和安装说明在 GitHub 上：https://github.com/yoanbernabeu/grepai