For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/changelog/search-backend-unify.md.
Hunea
  • English

      • Search backend unification and read-only path relaxation

      • Date: 2026-08-06
      • Commit: refactor(search): switch find to a single Rust backend and relax read-only paths
      • Version cue: 0.12.1-alpha.3

      Previously, find tried to download a managed fd binary when fd wasn't on the system, otherwise it fell back to a built-in fallback; meanwhile, read-only tools like read / grep / find / list_dir / view_image could only access paths inside the current workspace, and anything outside always failed. This change unifies search path access under a single Rust backend and relaxes the path boundary for read-only tools.

      What changed

      1. find now uses a single Rust backend
        find no longer depends on a system or managed fd binary — it consistently uses the built-in ignore + globset backend for path matching. It works identically whether or not fd is present, and removes one more binary to download / authorize.

      2. Read-only tools can access existing paths outside the workspace
        Read-only tools (read / grep / find / list_dir / view_image) can now access existing paths outside the workspace, no longer forced inside it. The boundaries for write / edit / bash (working directory) are unchanged — they still only operate inside the workspace.

      3. allow_managed_fd config removed
        The allow_managed_fd option is gone; only allow_managed_rg remains. allow_managed_rg now takes three forms: omitted means ask when a download is actually needed; true allows download / rebuild; false disables managed ripgrep (Hunea then still prefers the PATH / bundled rg, and only falls back to the Rust backend when neither is available).

      4. Streaming grep built-in fallback
        The grep built-in fallback is now implemented with grep-searcher in a streaming fashion and supports an external search root — more memory-efficient and faster at producing results when searching large directories.

      Notes

      • Path boundaries and usage guidance for file tools are in File tools.
      • If the config.toml example still includes allow_managed_fd, trust this entry; it will be synced later.