让AI编程助手用上tgrepCopilot CLI、Codex与pi的MCP高速搜索集成指南【免费下载链接】tgrepTrigram-indexed grep with a client/server architecture for fast regex search in large codebases locally项目地址: https://gitcode.com/gh_mirrors/tg/tgreptgrep 是一个基于三元组trigram索引的快速正则搜索工具采用客户端/服务器架构让 AI 编程助手在大型代码库中以毫秒级速度完成代码搜索。本文带你一步步把 tgrep 的 MCP 搜索工具装进 GitHub Copilot CLI、Codex 和 pi让你的 AI 助手瞬间拥有超级搜索能力。为什么 AI 编程助手需要更快的搜索AI 编码助手的每一个任务——修 bug、重构、理解架构——都始于代码搜索。传统上它们依赖rgripgrep实时扫描整个仓库在几十万文件的巨型代码库中一次全量扫描可能耗时数秒到数十秒AI 一轮任务往往要发起多次搜索等待时间被成倍放大搜索越慢助手思考—检索—再思考的循环就越卡顿。tgrep 的解法是预先建好三元组索引把搜索范围从所有文件缩小到可能匹配的文件再用正则引擎并行验证。在官方 2026 年 8 月的基准测试中tgrep 在 18 组仓库 × 平台组合中的 17 组跑赢了 ripgrep最快提升51.9 倍Gecko 仓库macOS。数据详见 BENCHMARKS.md。 tgrep 已被集成进GitHub Copilot CLI为其提供大仓库中的快速 grep 能力——这是它为 AI 而生的最直接证明。30秒搞懂 tgrep索引、服务与搜索三件套在集成之前先建立正确的心智模型。tgrep 可以理解为带预建索引和常驻服务的 ripgreptgrep index . # 一次性把索引建到 ./.tgrep tgrep serve . # 每个会话一次保持索引热态并监听文件变化 tgrep -- pattern . # 每次搜索自动找到服务器毫秒级返回每次搜索按以下优先级自动降级你或你的 AI 助手永远不需要手动选择优先级模式说明1️⃣本地服务器通过 TCP 查询最快文件监听器让索引紧跟磁盘变化2️⃣磁盘索引没有服务器时直接读.tgrep/速度依然快3️⃣全量扫描没有索引时退化为 grep 式扫描正确但慢这套机制的完整说明见 AGENTS.md它是专门写给 AI 编码助手以及接线的人类的指南。一键安装 Codex 与 pi 的 MCP 搜索工具tgrep 自带一个本地安装器把stdio MCP 工具 启动预热钩子 搜索指导说明一次性装进 Codex 或 pi不需要安装任何 Python 包也不是curl | sh式的远程脚本。环境要求Linux / macOSPython 3.11。最快安装步骤git clone https://gitcode.com/gh_mirrors/tg/tgrep cd tgrep bash install-agent.sh # 交互式选择 agent 与作用域非交互式安装也只需一行参数组合./install-agent.sh install --agent codex,pi --root /path/to/repository # 指定仓库的项目级安装 ./install-agent.sh install --agent codex --scope user # 用户级所有会话通用 ./install-agent.sh install --agent pi --binary /path/to/tgrep --max-filesize 8M管理命令同样简单./install-agent.sh doctor --agent codex,pi --root /path/to/repo # 校验安装 ./install-agent.sh repair --agent codex,pi --root /path/to/repo # 恢复缺失文件 ./install-agent.sh uninstall --agent codex,pi --root /path/to/repo完整的安装器说明包括路径解析、修复与卸载细节在 scripts/agent/README.md 中入口脚本是 install-agent.sh核心逻辑在 scripts/agent/install.py。安装器到底装了什么Agent安装内容Codexmcp_servers.tgrep配置项、SessionStart命令钩子会话启动时预热索引、AGENTS.md中的一段简短受管说明。已有的 MCP 服务器、钩子和指令原样保留pi.pi/extensions/tgrep.ts扩展文件用户级为~/.pi/agent/extensions/tgrep.ts通过 pi 扩展 API 注册工具、预热和搜索指导不覆盖任何内建工具两个集成都会鼓励模型主动采用搜索工具但不会拦截任意 shell 命令也不会保证模型永不使用rg——这是务实而非激进的设计。⚠️ 装完 Codex 后需要重启且项目配置必须被信任新钩子需在 Codex 的/hooks中通过审查/信任安装器不会绕过该策略。pi 用户重启或执行/reload即可。两大 MCP 工具详解search_code 与 find_files安装完成后AI 助手会获得两个工具pi 中注册为tgrep_search_code与tgrep_find_files它们连接同一个 Python MCP 服务核心定义见 scripts/agent/runtime.py1️⃣ search_code仓库内容搜索搜符号、引用、实现、配置返回文件路径、行号与上下文。常用参数pattern搜索模式默认按字面量匹配literal: true避免正则转义踩坑file_types/glob按文件类型如rust、py或 glob 收窄范围context_lines0–10 行上下文默认 2 行output_modecontent内容、files仅文件名、count每文件计数freshnessindexed走索引可能略滞后于文件系统或current强制读当前文件用于验证刚完成的编辑max_results1–1000 条输出记录默认 100。2️⃣ find_files按文件名找文件用文件基名或仓库相对路径的 glob如**/*.rs过滤可搜索文件列表。它遵守 ignore 规则不会重新包含被忽略的文件。内置的安全与体验细节对新手很友好搜索路径被规范化后必须位于仓库根之内越界和符号链接逃逸会被拒绝输出结果约 48 KB 上限超限会明确告知截断查询 30 秒超时可被取消无匹配结果属于成功而非错误——AI 助手不会把它误判为故障响应会标注本次是indexed_or_scan还是current_scan模式。Copilot CLI 用户零配置直接受益 ✅如果你用的是 GitHub Copilot CLI无需任何手动集成tgrep 已内建其中为其提供大仓库快速 grep 搜索。只要环境中装有 tgrep 二进制Copilot CLI 的搜索体验就自动获得三元组索引加速。想体验完整能力参考 README.md 中的安装章节Homebrew、预编译二进制或源码构建均可。AI 助手搜索实战4 个高效习惯 安装只是开始下面的习惯能让 AI 助手真正搜得又快又准优先用工具而非 shell让模型调用search_code/find_files输出更结构化、体积更受控宽查询先拿文件名用output_mode: files先定位文件再对具体文件做内容搜索输出保持精简验证最新编辑用freshness: current索引可能落后于刚发生的写入改完代码立即搜索时切换当前扫描索引、服务、搜索三者的参数要一致如自定义了--index-path、--max-filesize搜索时必须带同样的值否则会悄悄搜索不同的文件集合详见 AGENTS.md 的 Keep flags aligned 部分。遇到问题先查这张排错表 ️症状原因解决warning: no index at ... - scanning every file搜索时找不到索引传相同的--index-path或运行tgrep index ./tgrep serve .Server unreachable, falling back to local index服务器已死或状态文件过期重启tgrep serve .新文件搜不到无服务器磁盘索引早于文件创建时间重新运行tgrep index .服务器在跑搜索却慢某些参数绕过了索引去掉该参数或用file_types/glob收窄范围日常可以用tgrep status .一眼确认服务器 PID、端口、索引完成度与监听器状态。相关文件速查文件用途AGENTS.mdAI 编码助手使用 tgrep 的官方指南install-agent.shCodex / pi 集成安装器入口scripts/agent/README.md安装器完整文档MCP 行为、服务共享、修复卸载scripts/agent/runtime.py无依赖的本地 MCP 适配器与服务启动器scripts/agent/pi-extension.ts安装到 pi 的扩展模板BENCHMARKS.md各平台搜索速度与索引内存基准数据scripts/benchmark.sh自行复测基准的脚本结语让 AI 编程助手用上 tgrep只需要一次 clone 一条安装命令索引建好后Codex、pi 的每个会话都在毫秒内获得全仓库搜索能力Copilot CLI 用户则开箱即用。搜索是 AI 助手理解代码的第一步——把第一步做快整条工作流都会因此提速。【免费下载链接】tgrepTrigram-indexed grep with a client/server architecture for fast regex search in large codebases locally项目地址: https://gitcode.com/gh_mirrors/tg/tgrep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
