AI编码代理的驻留索引搜索：针对Pi代理、T3代码和MCP客户端的子ms路径+三元组内容搜索。Rust守护进程，git感知，DLP清除。
概览
支持全盘文件系统搜索、trigram内容grep，以及针对、和MCP客户端的Git感知代码发现——由持久驻留的Rust守护进程（ultrasearch）支持。 早期版本的README引用最佳情形温缓存微基准，仿佛是会话级别的数据，并声称有一个从未存在过的绿色CI。以下每个图表现在都标注了其测量范围，完整审计（AUDIT-2026-10-14.md）列出了哪些被夸大了，哪些发生了变化。实时性能、限制和开放差距被记录下来，而非遗漏。 代理在寻找、RG和grep -rn子进程时会损失时间和上下文。pi-ultrasearch保留文件系统的常驻索引（路径+三元组内容），并通过UNIX套接字在工作区边界内回答这些问题。
概述（AI 翻译）
全盘文件系统搜索、三角图内容 grep 以及针对 Pi Agent、T3 代码 和 MCP 客户端的 git 识别代码发现——由持久驻留的 Rust 守护进程（[
ultrasearch）支持。
诚实说明。 早期版本的 README 引用了最佳情形的温缓存微基准测试，仿佛它们是 会话级别的数字，并声称有一个从未存在过的绿色配置群。以下每个数字现在都标注为其 测量范围，完整审计（
AUDIT-2026-10-14.md）列出了哪些被夸大了，哪些发生了变化。 现场表演，限制和空隙被记录而非遗漏。
这是什么
代理会失去时间和上下文，分别是find、rg和grep -rn子过程。pi-ultrasearch 保持驻留索引
文件系统（路径 + 三元组内容）的 ，并通过 UNIX 套接字在 **0.03–0.5 毫秒*内回答这些问题
保持在工作区的边界内。
它的发货方式如下：
- Pi代理扩展（6个工具+度量工具+
/ultrasearch命令）， - 独立CLI（
ultrasearch query|grep|metrics|tui|compact）， - 一个stdio MCP服务器，用于Antigravity、VS Code、Claude Desktop及任何MCP客户端，
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
pi-ultrasearch
Whole-disk filesystem search, trigram content grep, and git-aware code discovery for Pi Agent, T3 Code, and MCP clients — backed by a persistent resident Rust daemon (
ultrasearch).
Honesty note. Earlier versions of this README quoted best-case warm-cache micro-benchmarks as if they were session-level numbers, and claimed a green CI that never existed. Every figure below is now labelled with its measurement scope, and the full audit (
AUDIT-2026-10-14.md) lists what was inflated and what changed. Live performance, limits and open gaps are documented rather than omitted.
Versions
Two artifacts version independently, and that is deliberate:
| Artifact | Where | Current |
|---|---|---|
| Engine + app | engine/Cargo.toml — the daemon, the CLI and the MCP server |
0.2.1 |
| Pi extension | package.json — the native tool surface Pi loads |
0.3.1 |
install.sh reads the engine version from Cargo.toml and writes it into both
CFBundleShortVersionString and CFBundleVersion, so the app bundle, the crate
and the MCP serverInfo always agree. The extension is a separate npm package
with its own release line; init --list reports it as extension rather than
no, because Pi takes the tools natively instead of through an MCP entry.
What it is
Agents lose time and context to find, rg, and grep -rn subprocesses. pi-ultrasearch keeps a resident index
of the filesystem (paths + trigram content) and answers those questions over a UNIX socket in 0.03–0.5 ms while
staying inside the workspace boundary.
It ships as:
- a Pi Agent extension (6 tools + metrics tool +
/ultrasearchcommands), - a standalone CLI (
ultrasearch query|grep|metrics|tui|compact), - a stdio MCP server for Antigravity, VS Code, Claude Desktop, and any MCP client,
- QuickJS Code Mode compatible tools (the Pi harness exposes registered tools to the sandbox).
Naming and sockets
Everything user-facing is UltraSearch-only: the tools are ultrasearch_query, ultrasearch_grep,
ultrasearch_multi_grep, ultrasearch_locate, ultrasearch_recent, ultrasearch_metrics; the slash command is
/ultrasearch; the CLI is ultrasearch / ultrasearch-tui / ultrasearch-mcp. No fsearch_* alias is registered
on any surface. Remaining fsearch references are upstream attribution, legacy socket compatibility, or historical
audit records; the upstream MIT notice is preserved in NOTICE.
| Platform | Default daemon socket |
|---|
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"ultrasearch": {
"command": "node",
"args": ["/Users/your-name/.pi/agent/extensions/pi-ultrasearch/dist/bin/mcp-server.js"]
}
}
}