Use when a task involves locating files or directories by path/name pattern in a filesystem or repo, especially as a faster alternative to find, fd, or ls piped to grep. Prefer it for path searches, filtering to files or directories, regex path matching, hidden-entry inclusion, and machine-readable output for downstream tools. Do not use it for file-content search; use rg for that.
2026-03-28