grepai

AI 时代的 grep

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

文档 · 安装 · 快速开始

---

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

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

特性

• 按意图搜索 — 询问“authentication logic”（认证逻辑）即可找到 handleUserSession
• 追踪调用图（Call Graphs） — 在修改代码前，清晰了解谁调用了某个函数
• 100% 本地运行 — 你的代码永远不会离开本地机器
• 始终保持最新 — 文件监视器自动保持索引更新
• 适配 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