ghost-9/pi-ultrasearch
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Resident-index search for AI coding agents: sub-ms path + trigram content search for Pi Agent, T3 Code and MCP clients. Rust daemon, git-aware, DLP-scrubbed.
概要
Whole-disk filesystem search, trigram content grep, and git-aware code discovery for , , and MCP clients — backed by a persistent resident Rust daemon (ultrasearch). 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. 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 while staying inside the workspace boundary.
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 MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"ultrasearch": {
"command": "node",
"args": ["/Users/your-name/.pi/agent/extensions/pi-ultrasearch/dist/bin/mcp-server.js"]
}
}
}