---

grepai 是一个以隐私优先的命令行工具（CLI），用于语义化代码搜索。它使用向量嵌入（vector embeddings）理解代码含义，支持自然语言查询，即使命名规范不同也能找到相关代码。

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

功能特性

• 按意图搜索 — 输入“认证逻辑”，即可找到 handleUserSession
• 追踪调用图（call graphs） — 在修改函数前，先知道谁调用了它
• 100% 本地运行 — 你的代码永远不会离开你的机器
• 始终最新 — 文件监听器自动保持索引更新
• 开箱即用支持 AI Agent — 原生兼容 Claude Code、Cursor、Windsurf
• MCP 服务器 — 你的 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 provider）—— 默认使用 Ollama，也支持 LM Studio 或 OpenAI。

Ollama（推荐）:

ollama pull nomic-embed-text

快速开始

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

Shell 自动补全

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

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

开发者评价

“我刚刚达到了 token 上限，仅读取我的代码库就消耗了 max5 计划的 13%。我对你的新工具感到非常、非常兴奋。”
— u/911pleasehold 在 r/ClaudeAI（浏览量超 28 万）

“效果很棒！安装只需 5 分钟。太疯狂了！”
— @LesSaleGeek 在 X 上

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

为什么选择 grepai？

grep 诞生于 1973 年，专为精确文本匹配设计。现代代码库需要语义理解能力。

	grep / ripgrep	grepai
搜索方式	精确文本 / 正则表达式	语义理解
查询示例	"func.*Login"	"用户认证流程"
查找结果	模式匹配项	概念相关的代码

文档

完整文档、指南和博客：

• 文档 — 配置、AI Agent 集成、MCP 设置
• 博客 — 性能基准、教程、版本说明

贡献

贡献指南请参阅 CONTRIBUTING.md。

许可证

MIT 许可证 - Yoan Bernabeu 2026

grepai 快速上手指南

grepai 是一个面向 AI 时代的语义代码搜索 CLI 工具，支持通过自然语言理解代码含义，100% 本地运行，保障隐私安全。

环境准备

• 操作系统：Linux / macOS / Windows（PowerShell）
• 前置依赖：
  • 安装 Ollama（推荐）、LM Studio 或配置 OpenAI API
  • 若使用 Ollama（默认），需提前拉取嵌入模型：

    ollama pull nomic-embed-text
    

💡 国内用户可考虑使用 Ollama 中文社区镜像 或配置代理加速模型下载。

安装步骤

macOS（推荐 Homebrew）：

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

⚠️ 如遇网络问题，可手动下载对应平台的二进制文件：GitHub Releases

基本使用

在你的项目根目录执行以下命令：

grepai init                        # 初始化项目索引
grepai watch                       # 启动后台索引服务（自动监听文件变更）
grepai search "error handling"     # 用自然语言语义搜索代码
grepai trace callers "Login"       # 查找调用 "Login" 函数的所有位置

✅ 首次运行 grepai init 后，建议保持 grepai watch 在后台运行以维持索引实时更新。