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.
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 — the only remaining fsearch strings in this repository are upstream attribution (see NOTICE).
| Platform | Default daemon socket |
|---|---|
| macOS | ~/Library/Application Support/UltraSearch/ultrasearch.sock |
| Linux | $XDG_RUNTIME_DIR/ultrasearch.sock, else ~/.local/share/ultrasearch/ultrasearch.sock |
| Windows | \\.\pipe\ultrasearch |
All environment overrides use the PI_ULTRASEARCH_* prefix.
Measured performance (live, 2026-10-14, Apple Silicon)
Warm socket micro-benchmarks (resident daemon, repeated calls)
| Operation | p50 | p95 | Notes |
|---|---|---|---|
| IPC ping | 0.031 ms | 0.112 ms | pure round-trip, 100 calls |
| Path search — small repo | 0.365 ms | 1.106 ms | 50 calls |
| Path search — Swift app repo | 0.475 ms | 1.141 ms | 20 calls |
| Trigram grep — small repo | 0.153 ms | 0.297 ms | 20 calls |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"ultrasearch": {
"command": "node",
"args": ["/Users/batra/.pi/agent/extensions/pi-ultrasearch/dist/bin/mcp-server.js"]
}
}
}