Drive-wide NTFS file search with full paths for oh-my-pi. Query millions of files in milliseconds, Everything/WizFile-style, backed by the open-source FindX engine (Rust, MIT OR Apache-2.0: MFT enumeration + USN journal).
Design principle: wrap a competent engine instead of hand-rolling an MFT
parser. This plugin is a thin adapter between omp's tool registry and the
findx2 CLI — ~8 files, zero runtime dependencies.
| Tool | Purpose |
|---|---|
fastsearch |
Query a prebuilt index. Full paths, milliseconds. Rich query syntax (AND/OR/exclude, ext:, size:, dm:, parent:, dupe:). |
fastsearch_index |
Build (mode: "full") or keep fresh (mode: "watch", detached USN watcher) the index for a volume. Escalates via a UAC prompt when needed — omp doesn't have to run as Administrator (escalate: false opts out for headless). |
fastsearch_status |
Report index freshness and coverage (build time, entries, per-volume USN cursor). |
# 1. Build the FindX CLI (needs Rust: https://rustup.rs)
cd fastsearch-omp
bun run build # clones findx (pinned tag) + cargo build --release + stages native/bin/findx2.exe
# 2. Link into omp
omp plugin link (Resolve-Path .)
# 3. Restart omp. Build the index ONCE per drive:
# call fastsearch_index (volume: "C:") - a UAC prompt appears, click Yes.
# omp itself never needs to run as Administrator.First-time index build takes a UAC click and a few minutes for large drives;
after that, queries run unprivileged and return in milliseconds. Index lives at
~/.omp/fastsearch/index.bin (override with FASTSEARCH_INDEX; binary override
FASTSEARCH_FINDX2).
- Names + metadata only (timestamps, sizes, attributes) — no file contents.
- Persistent index (tens–hundreds of MB). That is the Everything/WizFile architecture — the thing that actually delivers sub-second drive-wide search.
- Windows + NTFS only.
- FindX is young (single-maintainer); its design is serious (published benchmarks: 8.5M entries, ~80 ms search) but not battle-tested by a community.
MIT. The FindX engine is vendored at build time from
chaojimct/findx (pinned to v2.1.0 by
native/build.ps1), MIT OR Apache-2.0 — see native/findx-LICENSE and
native/findx-LICENSE-APACHE.