grepai

AI 时代的 grep

按含义而非文本搜索代码。

文档 · 安装 · 快速开始

---

grepai 是一款主打隐私优先的语义代码搜索 CLI 工具。它利用向量嵌入（Vector Embeddings）来理解代码含义，支持通过自然语言查询找到相关代码——即使命名习惯各不相同也不受影响。

通过提供相关上下文而非原始搜索结果，大幅减少 AI Agent 的输入 token 消耗。

功能特点

• 按意图搜索 — 输入“认证逻辑”，即可找到 handleUserSession。
• 追踪调用图（Call Graphs） — 在修改函数前，明确谁调用了该函数。
• 100% 本地运行 — 您的代码绝不会离开本地机器。
• 实时更新 — 文件监控器（File watcher）自动保持索引为最新状态。
• AI Agent 就绪 — 开箱即用，支持 Claude Code、Cursor、Windsurf。
• MCP server — 您的 AI Agent 可以直接调用 grepai 作为工具。

安装

Homebrew (macOS):

brew install yoanbernabeu/tap/grepai

Linux/macOS:

curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex

需要一个 embedding 提供程序 —— Ollama (默认)、LM Studio 或 OpenAI。

Ollama (推荐):

ollama pull nomic-embed-text

快速开始

grepai init                        # 在您的项目中进行初始化
grepai watch                       # 启动索引守护进程
grepai search "error handling"     # 进行语义搜索
grepai trace callers "Login"       # 查找谁调用了该函数

Shell 自动补全

grepai 支持命令、标志（flags）以及动态值（工作区名称、项目名称、提供程序、后端）的自动补全。

Zsh (添加到 ~/.zshrc):

eval "$(grepai completion zsh)"

Oh-My-Zsh 插件:

mkdir -p ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/grepai
grepai completion zsh > ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/grepai/_grepai
# 然后在 ~/.zshrc 中的 plugins=(...) 里添加 "grepai"

Bash:

# Linux
grepai completion bash > /etc/bash_completion.d/grepai

# macOS (需要 bash-completion@2)
grepai completion bash > $(brew --prefix)/etc/bash_completion.d/grepai

Fish:

grepai completion fish > ~/.config/fish/completions/grepai.fish

PowerShell:

grepai completion powershell | Out-String | Invoke-Expression

开发者评价

“我刚刚达到了限制，仅仅为了读取我的代码库就消耗了 max5 计划的 13%。我对你们的新工具感到非常兴奋。” — u/911pleasehold 在 r/ClaudeAI (28万+ 次浏览)

“它运行得非常棒！安装只需 5 分钟。太疯狂了！” — @LesSaleGeek 在 X 上

“搜索结果令人难以置信！” — Kenny Nguyen 在 LinkedIn 上

为什么选择 grepai？

grep 诞生于 1973 年，旨在进行精确的文本匹配。而现代代码库需要的是语义层面的理解。

	grep / ripgrep	grepai
搜索方式	精确文本 / 正则表达式	语义理解
查询示例	"func.*Login"	"user authentication flow"
搜索结果	模式匹配	概念相关的代码

文档

完整的文档、指南和博客：

• 文档 — 配置、AI Agents、MCP 设置
• 博客 — 基准测试、教程、发布说明

贡献

请参阅 CONTRIBUTING.md 了解相关准则。

许可证

MIT License - Yoan Bernabeu 2026