Skip to content

needle v0.1.0

Choose a tag to compare

View all tags
@Dedsec-Xu Dedsec-Xu released this 29 Jun 13:23
v0.1.0
c0a57c1

First tagged release of needle — a whole-machine, sub-millisecond file-search MCP server for AI agents (Windows / NTFS).

Highlights

  • Reads the NTFS MFT directly and keeps a warm in-memory index, refreshed incrementally from the USN Journal.
  • fast_glob MCP tool so an agent can find any file on the machine in well under a millisecond.
  • Extension inverted index: whole-volume extension globs answered in 0.2–0.9 ms on a 2.27M-file drive.
  • ~400x faster than the pre-index full scan; beats Everything's es.exe ~3x and traversal tools (fd/dir/ripgrep) by 79–1049x in the bundled head-to-head.
  • Split daemon + MCP frontend to cross the admin boundary; installable as a Windows service (LocalSystem, auto-start) so the daemon never needs manual launch.
  • Subcommands: find, query, bench, serve, mcp, service install/uninstall.

Known limitations / next up

  • Whole-machine search currently indexes per-drive on demand; true multi-drive enumeration is the next milestone.
  • No automated tests / CI yet.
  • Loopback query API is unauthenticated.
Assets 2
Loading