{"id":50696468,"url":"https://github.com/skyllc-ai/ultrafastfilesearch","last_synced_at":"2026-06-09T07:00:39.931Z","repository":{"id":252345009,"uuid":"840153813","full_name":"skyllc-ai/UltraFastFileSearch","owner":"skyllc-ai","description":"Ultra-fast file search for Windows using NTFS MFT","archived":false,"fork":false,"pushed_at":"2026-06-05T15:12:40.000Z","size":257840,"stargazers_count":10,"open_issues_count":12,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-05T15:18:14.052Z","etag":null,"topics":["agent-tools","cli","command-line-tool","desktop-search","developer-tools","everything-alternative","file-search","filesystem","forensics","indexing","mcp","mft","model-context-protocol","ntfs","rust","search-engine","sysadmin","usn-journal","windows","windows-search"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skyllc-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"uffs-search","ko_fi":"ufffssearch"}},"created_at":"2024-08-09T04:54:03.000Z","updated_at":"2026-06-05T15:12:44.000Z","dependencies_parsed_at":"2024-08-09T06:46:08.416Z","dependency_job_id":null,"html_url":"https://github.com/skyllc-ai/UltraFastFileSearch","commit_stats":null,"previous_names":["githubrobbi/ultrafastfilesearch-rust","githubrobbi/ultrafastfilesearch"],"tags_count":98,"template":false,"template_full_name":null,"purl":"pkg:github/skyllc-ai/UltraFastFileSearch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyllc-ai%2FUltraFastFileSearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyllc-ai%2FUltraFastFileSearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyllc-ai%2FUltraFastFileSearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyllc-ai%2FUltraFastFileSearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skyllc-ai","download_url":"https://codeload.github.com/skyllc-ai/UltraFastFileSearch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skyllc-ai%2FUltraFastFileSearch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34095247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","cli","command-line-tool","desktop-search","developer-tools","everything-alternative","file-search","filesystem","forensics","indexing","mcp","mft","model-context-protocol","ntfs","rust","search-engine","sysadmin","usn-journal","windows","windows-search"],"created_at":"2026-06-09T07:00:25.257Z","updated_at":"2026-06-09T07:00:39.903Z","avatar_url":"https://github.com/skyllc-ai.png","language":"Rust","funding_links":["https://opencollective.com/uffs-search","https://ko-fi.com/ufffssearch"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/brand/uffs-wordmark.png\" alt=\"UFFS — Ultra Fast File Search\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eWire-speed search across your NTFS drives. No indexing. No waiting.\u003c/b\u003e\u003cbr\u003e\n  \u003csub\u003eA Rust-native engine by \u003ca href=\"https://github.com/skyllc-ai\"\u003eSky, LLC\u003c/a\u003e — open source, MPL-2.0.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/skyllc-ai/UltraFastFileSearch/actions/workflows/pr-fast.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/skyllc-ai/UltraFastFileSearch/pr-fast.yml?branch=main\u0026label=CI\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/skyllc-ai/UltraFastFileSearch?label=release\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/skyllc-ai/UltraFastFileSearch/total?label=downloads\" alt=\"Total Downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg\" alt=\"License: MPL 2.0\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/platform-Windows-blue.svg\" alt=\"Platform: Windows\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://opencollective.com/uffs-search\"\u003e\u003cimg src=\"https://img.shields.io/badge/Sponsor-Open%20Collective-3385FF?logo=opencollective\u0026logoColor=white\" alt=\"Sponsor on Open Collective\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://ko-fi.com/ufffssearch\"\u003e\u003cimg src=\"https://img.shields.io/badge/Tip-Ko--fi-FF5E5B?logo=ko-fi\u0026logoColor=white\" alt=\"Tip on Ko-fi\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**A benchmark-driven NTFS search engine for Windows.** UFFS reads the Master File Table directly, builds a compact persisted index, and keeps large NTFS estates searchable through a background daemon.\n\n\u003e Proven on a real 7-drive, 25.9M-record Windows system; scale-ceiling tested to **100.4M records** with offline MFT clones (v0.5.4 baseline; v0.5.71 current):\n\u003e - **68.5 s COLD** — raw MFT read + compact index build (v0.5.71, flat ± 4 % vs v0.5.4)\n\u003e - **5.7 s WARM CACHE** — restart from serialized cache (v0.5.62/v0.5.71, **−17 %** vs v0.5.4)\n\u003e - **0–3 ms daemon-side** for targeted queries — exact/prefix/ext/substring, unchanged from v0.5.4\n\u003e - **29–32 ms CLI end-to-end** for targeted queries on v0.5.71 (v0.5.4 measured 9–13 ms e2e before the post-Phase-1 thin-client spawn floor settled at ~28 ms)\n\u003e - **vs Everything on v0.5.71**: UFFS wins **12/12 head-to-head cells** at p50 on C+D, median ratio **0.51× (~1.96× faster)** — see the [**benchmark hub**](docs/benchmarks/) and the [full v0.5.71 report](docs/benchmarks/2026-04-v0.5.71-vs-everything-and-cpp.md)\n\nUFFS is built for **exact filename, path, and metadata search** at scales where directory walking, shell search, and some automation surfaces become the bottleneck. It is open source, written in Rust, and designed first for deterministic local search; CLI, TUI, API, and MCP are all interfaces on top of the same engine.\n\n\u003e An open-source NTFS search engine for Windows power users, developers, IT teams, and investigations-style workflows.\n\n📖 **[Full User Manual](docs/user-manual/index.md)** — installation, tutorials, filters, daemon, TUI, MCP integration, and more.\n\n\u003e **Open source, forever.** The UFFS platform — engine, daemon, CLI, and MCP server — is licensed under the [Mozilla Public License 2.0](LICENSE). Code released as part of UFFS Core will never be made less open. Commercial products and enterprise offerings are built on top of the open platform, not by restricting it.\n\n---\n\n## Why UFFS?\n\n- ⚡ **100M-record proven scale** — measured from 25.9M across 7 drives up to 100.4M across 16 drives\n- 🚀 **Cold / warm / hot architecture** — build once from raw MFT, restart fast from cache, answer hot queries from memory\n- 🔍 **40+ filters** — size, date, extension, type, attributes, path length, tree size, regex\n- 🧩 **One engine, multiple interfaces** — CLI, TUI, daemon, API, and MCP share the same index\n- 🧭 **Deterministic local scope** — built for exact NTFS filename/path/metadata search, not fuzzy ranking\n- 🔒 **No telemetry, fully local** — UFFS makes no outbound network calls; your index and queries never leave your machine (the optional MCP gateway binds a local-only port you explicitly enable)\n- 🖥️ **Cross-platform offline analysis** — live NTFS on Windows; offline MFT analysis on macOS and Linux\n\n---\n\n## See it in action\n\nEvery clip runs the **real binary** against real NTFS data with unedited timings and result counts — captured with the reproducible [demo kit](scripts/dev/demo/README.md).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo/uffs-tui-short.gif\" alt=\"UFFS TUI: unzip, run uffs-tui, and browse your real NTFS drives against a hot daemon in seconds.\" width=\"900\"\u003e\u003cbr\u003e\n  \u003csub\u003e\u003cb\u003eTUI\u003c/b\u003e — unzip, run \u003ccode\u003euffs-tui\u003c/code\u003e, and browse your own drives in seconds. \u003ca href=\"assets/demo/uffs-tui.gif\"\u003eFull reel\u003c/a\u003e.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo/uffs-cli-short.gif\" alt=\"UFFS CLI: real searches, filters, and aggregations across 25.9M indexed files with measured latency.\" width=\"900\"\u003e\u003cbr\u003e\n  \u003csub\u003e\u003cb\u003eCLI\u003c/b\u003e — real commands, real result counts, real measured latency on a hot daemon. \u003ca href=\"assets/demo/uffs-cli.gif\"\u003eFull 9-step reel\u003c/a\u003e.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo/uffs-mcp-claude.gif\" alt=\"Claude using the UFFS MCP server to find the largest video files and summarize storage by file type.\" width=\"900\"\u003e\u003cbr\u003e\n  \u003csub\u003e\u003cb\u003eMCP\u003c/b\u003e — Claude querying your filesystem through the UFFS MCP server. Deterministic search underneath, MCP on top.\u003c/sub\u003e\n\u003c/p\u003e\n\n---\n\n## Benchmark snapshot (v0.5.71)\n\nMeasured on AMD Ryzen 9 3900XT, 64 GB RAM, Windows 11 Pro 24H2, 7 NTFS volumes totaling 26.1 M records; scaled to 100.4 M with offline MFT clones (v0.5.4 era). Full captures in [`docs/benchmarks/raw/2026-04-v0.5.66_cross-tool-vs-everything.txt`](docs/benchmarks/raw/2026-04-v0.5.66_cross-tool-vs-everything.txt) + [`docs/benchmarks/raw/2026-04-v0.5.66_full-benchmark-suite.txt`](docs/benchmarks/raw/2026-04-v0.5.66_full-benchmark-suite.txt). Publication-grade report: [**docs/benchmarks/**](docs/benchmarks/).\n\n| Phase | What happens | ALL 7 drives (v0.5.71) | Single NVMe (v0.5.4) |\n|-------|--------------|-----------------------:|---------------------:|\n| **COLD** | Raw MFT read, parse, compact index build, cache write | 68.5 s | 7.7 s |\n| **WARM CACHE** | Daemon restart + serialized cache load | **5.7 s** | 6.4 s |\n| **HOT (`*` top-100)** | Full-scan across all drives with `--limit 100` | **1 112 ms** e2e¹ | 27 ms (v0.5.4) |\n| **HOT (targeted)** | `notepad.exe` / `win*` / `*.dll` / `config` etc. | **29–32 ms** CLI e2e | 9–10 ms (v0.5.4) |\n\n¹ The `*` top-100 path regressed from the v0.5.4 163 ms figure after the Phase 2 sort rewrite ([`docs/benchmarks/raw/2026-04-v0.5.66_full-benchmark-suite.txt:657`](docs/benchmarks/raw/2026-04-v0.5.66_full-benchmark-suite.txt), n=30, StdDev 21 ms). Daemon-side is 1 081 ms — CLI tax is negligible here. Bounded-heap top-N fix is Phase 5 target #2 in the [cross-tool analysis](docs/benchmarks/2026-04-v0.5.66-vs-everything-and-cpp.md#known-regressions) doc.\n\nHot-path context (v0.5.71, 30 rounds, p50):\n- **0–3 ms daemon-side** for targeted queries (exact, prefix, ext, substring, combined) — unchanged since v0.5.4\n- **29–32 ms CLI end-to-end** for targeted queries across all 7 drives (~28 ms post-Phase-1 cold-spawn floor + 0–3 ms daemon)\n- **UFFS wins 12/12 cells vs Everything** at p50 on C+D, median ratio **0.51×** — see the [benchmark hub](docs/benchmarks/)\n- **Direct stdout redirect crossover**: UFFS **0.27×–0.53×** vs ES across 4 size classes (34 K → 167 K rows)\n- **323 k rows/sec** bulk export throughput (CSV, `--out-dir`)\n- **Full-scan export** `*` → CSV at 26 M records: **13.6 s p50** (1.72 M rec/s through the full pipeline)\n- **100.4 M records** tested (v0.5.4 synthetic-clone data; not re-verified on v0.5.71): targeted queries stayed at 11–13 ms e2e\n\n\u003e 📖 **[Benchmark hub](docs/benchmarks/)** — dated competitive-benchmark reports, fairness methodology, archive of prior versions, reproduction scripts.\n\u003e 📖 **[Full benchmark data](docs/user-manual/performance.md)** — methodology, per-drive tables, interactive search percentiles, bulk retrieval, scale ceiling, and caveats.\n\n---\n\n## Download \u0026 Install\n\n\u003e **[⬇ Latest Release — GitHub Releases tab](https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest)**\n\nEach release ships pre-built binaries, a `CHECKSUMS.txt` (SHA256), per-crate SBOMs (CycloneDX), and SLSA build-provenance attestations — no build toolchain needed.\n\n| Platform | Download | Notes |\n|---|---|---|\n| **Windows x64** | [`uffs-windows-x64.zip`](https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest) | CLI + daemon + MCP + MFT tools + `uffs-tui` demo. Recommended. |\n| **macOS Apple Silicon** | [`uffs-macos-arm64.zip`](https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest) | Offline MFT analysis only. Includes `UFFS.app` bundle + `uffs-tui` demo. |\n| **Linux x64** | [`uffs-linux-x64.zip`](https://github.com/skyllc-ai/UltraFastFileSearch/releases/latest) | Offline MFT analysis only. Includes `install.sh` + `uffs-tui` demo. |\n\n\u003e 📦 **Three tiers per platform** — `…-min.zip` (just `uffs` + `uffsd` + the `uffs-tui` demo, for CI/scripting), the bare `….zip` (**recommended**: adds MCP + MFT tooling + docs), and `…-full.zip` (adds the `uffs-diag` diagnostic tools). Every tier bundles the free `uffs-tui` demo.\n\n\u003e 🖥️ **Fastest way to try it — no CLI required.** Unzip any tier and run **`uffs-tui`**: the daemon auto-starts and you're browsing your own drives in a UI within seconds. The bundled TUI is the free demo (capped result counts, exports disabled — see `DEMO-LICENSE.txt`); full TUI/GUI are commercial.\n\n**Windows quick-install (one command) — via [WinGet](https://learn.microsoft.com/windows/package-manager/):**\n```powershell\nwinget install SkyLLC.UFFS\n```\n\nOr grab the ZIP above, extract it anywhere, add the folder to PATH, then:\n```powershell\nuffs --version\n```\n\n**Verify the download:**\n```bash\n# SHA256 checksum\nsha256sum -c CHECKSUMS.txt\n\n# SLSA build-provenance attestation (proves the binary came from this exact workflow run)\ngh attestation verify uffs-windows-x64.exe --owner skyllc-ai\n```\n\n**Build from source** (contributors / nightly development only):\n```bash\n# Requires Rust nightly — channel is pinned in rust-toolchain.toml\ncargo build --release\n```\n\n\u003e 📖 **[Full installation guide](docs/user-manual/installation.md)** — WinGet, PATH setup, daemon autostart, Scoop (coming)\n\n\u003e 🖥️ **Prefer a UI?** The free **`uffs-tui` demo is bundled in every release ZIP** above — just run `uffs-tui`. Standalone demo builds of the TUI **and GUI** (macOS, Linux, Windows) also live at **[uffs-demo/releases](https://github.com/githubrobbi/uffs-demo/releases/latest)** — limited result counts, exports disabled. They drive this same open-source daemon. Full versions are commercial (see [Maintainership \u0026 Commercial](#maintainership--commercial)).\n\n---\n\n## Quick Start\n\n```bash\n# Search all drives (daemon starts automatically on first query)\nuffs \"*.rs\"\n\n# Search a specific drive\nuffs \"*.txt\" --drive C\n\n# Filter by size, date, type\nuffs \"*.log\" --min-size 100MB --newer 7d --files-only\n\n# macOS/Linux: search offline MFT captures\nuffs \"*.txt\" --data-dir ~/uffs_data\n\n# Daemon management\nuffs daemon status\nuffs daemon restart\n\n# Memory tiering — operator-driven controls (Phase 8)\nuffs daemon status_drives                 # per-drive tier + telemetry table\nuffs daemon hibernate                     # demote every drive to Cold (free RAM)\nuffs daemon preload C --pin-minutes 60    # pin a hot drive in RAM\nuffs daemon forget C --force              # evict + delete on-disk caches\n```\n\n\u003e 📖 **[Installation](docs/user-manual/installation.md)** · **[5-minute tutorial](docs/user-manual/getting-started.md)** · **[CLI reference](docs/user-manual/cli-overview.md)** · **[40+ filters](docs/user-manual/filters.md)**\n\n### Memory tiering at a glance\n\nThe daemon keeps each drive's compact index in one of four tiers, demoted automatically by an idle TTL ladder + memory-pressure cascade and promoted on first search:\n\n| Tier | RAM cost | Source-of-truth | When |\n|---|---|---|---|\n| **Hot** | full body + bloom + trie | live in RAM | actively pinned (post-`preload`) or recently queried |\n| **Warm** | full body + bloom + trie | live in RAM | default after load; ready for any search |\n| **Parked** | bloom + trie only | live in RAM | idle past warm TTL; can answer \"definitely not on this drive\" without re-promote |\n| **Cold** | (nothing in RAM) | encrypted compact cache on disk | idle past parked TTL or operator-hibernated; re-promote on next search |\n\nOperator commands let you tune this manually for known workload shapes — `preload` pins a search-heavy drive against demote, `hibernate` frees RAM during long idle stretches, `forget` permanently evicts a drive plus its on-disk caches, and `status_drives` surfaces the live tier + pin + query-rate snapshot.\n\n\u003e 📖 **[Memory-tiering Windows-host runbook](docs/architecture/memory-tiering-windows-host-validation.md)** — what to run on a multi-drive Windows box to validate the operator surface.\n\n---\n\n## How It Works\n\n1. **Read** — Opens the raw NTFS volume and reads the MFT sequentially using IOCP with a sliding window. Bitmap skip eliminates 40–55% of I/O by skipping deleted records.\n2. **Parse** — Each I/O buffer is parsed inline into a compact 224-byte `FileRecord` — zero intermediate copies, zero per-record heap allocations. On NVMe, Rayon parallelizes parsing across all CPU cores.\n3. **Index** — Records are stored in a compact in-memory index with extension and trigram accelerators for fast targeted queries. DataFrame/export paths are built on top of the same core engine.\n4. **Serve** — A background daemon holds the index in memory and answers queries via IPC. CLI, TUI, and MCP clients all share the same daemon.\n\n\u003e 📖 **[Architecture deep-dive](docs/architecture/engine/01-overview.md)** — 11 documents covering every subsystem.\n\n---\n\n## Architecture\n\n| Crate | Role |\n|-------|------|\n| `uffs-mft` | Direct MFT reading → compact in-memory index ([📖](crates/uffs-mft/README.md)) |\n| `uffs-core` | Query engine (Polars lazy API) |\n| `uffs-daemon` | Background index server ([📖](docs/user-manual/daemon.md)) |\n| `uffs-cli` | Command-line interface ([📖](docs/user-manual/cli-overview.md)) |\n| `uffs-mcp` | MCP server for AI agents ([📖](docs/user-manual/mcp.md)) |\n| `uffs-polars` | Polars compilation-isolation facade |\n| `uffs-client` | IPC client library |\n\n---\n\n## Alternatives \u0026 Landscape\n\nUFFS was built after the author wrote [an earlier C++ MFT search tool](https://github.com/githubrobbi/Ultra-Fast-File-Search) and then rebuilt it from scratch in Rust for safety, performance, and maintainability.\n\n### Comparison scope\n\nUFFS competes first in the **local NTFS filename/path/metadata** lane: exact search across large Windows filesystems with deterministic scope and a reusable in-memory daemon.\n\nWe do **not** collapse all search products into one \"fastest search tool\" claim. The following are different benchmark classes and should be compared separately:\n\n1. **Readiness** — cold build, warm restart, and hot query\n2. **Interactive search** — end-to-end top-N query latency\n3. **Bulk retrieval** — time to stream or export large result sets\n4. **Scale ceiling** — largest corpus completed without timeout, crash, or incorrect results\n\nThat distinction matters because a tool can be excellent at interactive top-N search and still hit a wall during full-result export or very large automation workloads.\n\nThe older C++ implementation remains useful as a parity and regression baseline, but it is **not** the headline market benchmark for the Rust engine. Public cross-tool comparisons should be run against the current Rust engine with exact versions, settings, workloads, and raw results published alongside the charts.\n\n### How UFFS compares to other file search tools\n\n| Category | Tools | How UFFS differs |\n|----------|-------|-----------------|\n| **Instant NTFS filename search** | [Everything (voidtools)](https://www.voidtools.com/), [WizFile](https://antibody-software.com/wizfile/), [WizTree](https://www.diskanalyzer.com/), [UltraSearch (JAM Software)](https://www.jam-software.com/ultrasearch), [SwiftSearch](https://sourceforge.net/projects/swiftsearch/), [Locate32](https://locate32.cogit.net/) | Open-source Rust engine; 100M-record proven scale; compact index + daemon + CLI + TUI + MCP; 40+ filters; forensic mode; cross-platform offline analysis |\n| **Content / regex search** | [FileLocator Pro / Agent Ransack](https://www.mythicsoft.com/filelocatorpro/), [grepWin](https://tools.stefankueng.com/grepWin.html), [AstroGrep](http://astrogrep.sourceforge.net/), [dnGrep](https://dngrep.github.io/), [SearchMyFiles (NirSoft)](https://www.nirsoft.net/utils/search_my_files.html) | UFFS focuses on MFT-level metadata speed; pairs well with `ripgrep` for content |\n| **Enterprise / eDiscovery** | [X1 Search](https://www.x1.com/), [dtSearch](https://www.dtsearch.com/), [Copernic](https://copernic.com/) | UFFS is a specialist local-NTFS tool, not a multi-repository governance platform |\n| **Developer CLI** | [fd](https://github.com/sharkdp/fd), [ripgrep](https://github.com/BurntSushi/ripgrep), [fzf](https://github.com/junegunn/fzf), [GNU find](https://www.gnu.org/software/findutils/) | UFFS reads the MFT instead of walking directories — orders of magnitude faster for whole-drive search |\n| **Forensic MFT tools** | [MFTECmd (Eric Zimmerman)](https://ericzimmerman.github.io/), [analyzeMFT](https://github.com/dkovar/analyzeMFT) | UFFS is an interactive search engine, not a one-shot parser; includes daemon, TUI, and live queries |\n| **Linux / macOS** | [FSearch](https://github.com/cboxdoerfer/fsearch), [Recoll](https://www.recoll.org/), [DocFetcher](https://docfetcher.sourceforge.net/), [Catfish](https://docs.xfce.org/apps/catfish/start), [Find Any File](https://findanyfile.app/), [HoudahSpot](https://www.houdah.com/houdahSpot/) | UFFS supports offline MFT analysis on macOS/Linux via cached index files |\n\n\u003e 📖 **[Full competitor landscape analysis](docs/mft_competitor_landscape_deep_research.md)** — 12 tools, corporate adoption data, market positioning.\n\n---\n\n## Requirements\n\n- **Windows** for live NTFS MFT reading (Administrator privileges required)\n- **macOS / Linux** for offline MFT analysis (no admin needed)\n- **Rust nightly** (Edition 2024) to build from source — channel pinned in `rust-toolchain.toml`; the workspace has no stable MSRV (see CONTRIBUTING.md → \"Toolchain policy\")\n\n---\n\n## Documentation\n\n| Topic | Link |\n|-------|------|\n| Installation | [docs/user-manual/installation.md](docs/user-manual/installation.md) |\n| Getting started (5 min) | [docs/user-manual/getting-started.md](docs/user-manual/getting-started.md) |\n| CLI overview \u0026 examples | [docs/user-manual/cli-overview.md](docs/user-manual/cli-overview.md) |\n| 40+ search filters | [docs/user-manual/filters.md](docs/user-manual/filters.md) |\n| Daemon management | [docs/user-manual/daemon.md](docs/user-manual/daemon.md) |\n| TUI interactive search | [docs/user-manual/tui-search-box.md](docs/user-manual/tui-search-box.md) |\n| MCP server (AI agents) | [docs/user-manual/mcp.md](docs/user-manual/mcp.md) |\n| Performance \u0026 benchmarks | [docs/user-manual/performance.md](docs/user-manual/performance.md) |\n| Cache \u0026 data sources | [docs/user-manual/cache-and-data.md](docs/user-manual/cache-and-data.md) |\n| Architecture (11 docs) | [docs/architecture/engine/](docs/architecture/engine/) |\n| FAQ | [docs/user-manual/faq.md](docs/user-manual/faq.md) |\n| Troubleshooting | [docs/user-manual/troubleshooting.md](docs/user-manual/troubleshooting.md) |\n\n---\n\n## Contributing\n\nStart with [CONTRIBUTING.md](CONTRIBUTING.md) for the pinned toolchain, `just`/`cargo` workflows, and Windows/Admin caveats. For the broader docs map, see [docs/README.md](docs/README.md) and [docs/dev/README.md](docs/dev/README.md).\n\n---\n\n## License \u0026 Trademarks\n\n**Code.** UFFS is licensed under the [Mozilla Public License 2.0 (MPL-2.0)](LICENSE).\n\nYou can use, modify, and distribute UFFS freely. If you modify MPL-covered source files and distribute the result, those file-level changes must remain under MPL-2.0. Building proprietary applications on top of UFFS does not require opening your application.\n\nSee [LICENSES/MPL-2.0.txt](LICENSES/MPL-2.0.txt) for the full license text and [Mozilla's MPL FAQ](https://www.mozilla.org/en-US/MPL/2.0/FAQ/) for plain-language guidance.\n\n**Brand.** The UFFS name, the UltraFastFileSearch wordmark, and the UFFS logo are project trademarks owned by [Sky, LLC](https://github.com/skyllc-ai). Usage is governed by [TRADEMARK.md](TRADEMARK.md) — not the MPL. Linking, reviews, tutorials, and unmodified redistributions are fine without asking; forks, merchandise, and commercial use of the mark need permission first.\n\n---\n\n## Maintainership \u0026 Commercial\n\nUFFS is developed and maintained by **[Sky, LLC](https://github.com/skyllc-ai)** — a systems-engineering shop focused on high-performance Rust tooling.\n\n- **Commercial UFFS frontends** (polished GUI / premium TUI) are in development on top of this open-source engine. For waitlist or partnership inquiries: [`uffs@nios.net`](mailto:uffs@nios.net) or open a [discussion](https://github.com/skyllc-ai/UltraFastFileSearch/discussions) with the `commercial-interest` label.\n- **Hiring / collaboration.** This repository is also the public engineering portfolio of its maintainer; see the [Sky, LLC org page](https://github.com/skyllc-ai) for the full pitch and contact details.\n- **Sponsorship.** UFFS is free and MPL-2.0 forever; sponsorships fund Windows code-signing, benchmark hardware, and release engineering. **Companies** (invoice / receipt via Sky, LLC): [Open Collective](https://opencollective.com/uffs-search). **One-time tip:** [Ko-fi](https://ko-fi.com/ufffssearch). Individual recurring tiers via **GitHub Sponsors** are being enrolled — the repo \"Sponsor\" button already lists the live channels above.\n\n## Acknowledgments\n\nUFFS benefits from the broader NTFS tooling ecosystem, including [SwiftSearch](https://sourceforge.net/projects/swiftsearch/) by wfunction. Deep competitive landscape analysis in [docs/mft_competitor_landscape_deep_research.md](docs/mft_competitor_landscape_deep_research.md).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\n    \u003cb\u003eMaintainer:\u003c/b\u003e Robert Nio ·\n    \u003cb\u003eOrganization:\u003c/b\u003e \u003ca href=\"https://github.com/skyllc-ai\"\u003eSky, LLC\u003c/a\u003e ·\n    \u003cb\u003eRepo:\u003c/b\u003e \u003ca href=\"https://github.com/skyllc-ai/UltraFastFileSearch\"\u003eskyllc-ai/UltraFastFileSearch\u003c/a\u003e\n  \u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskyllc-ai%2Fultrafastfilesearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskyllc-ai%2Fultrafastfilesearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskyllc-ai%2Fultrafastfilesearch/lists"}