Source Intelligence
Follow Discord

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

← All of v2.1.71 Home All releases ←olderv2.1.70 v2.1.72newer→
Claude Code v2.1.71

Embedded Search Tools (bfs/ugrep)

What

When enabled, Claude Code shadows the system find and grep commands with faster embedded alternatives — bfs (breadth-first search) and ugrep — providing significantly improved search performance in the shell.

Details
  • find is shadowed with bfs (breadth-first file search), configured with -regextype findutils-default for compatibility
  • grep is shadowed with ugrep, configured with --ignore-files, --hidden, -I (skip binary), and automatic exclusion of .git, .svn, .hg, .bzr directories
  • Controlled by the EMBEDDED_SEARCH_TOOLS environment variable
  • Only active when not running via SDK entrypoints (sdk-ts, sdk-py, sdk-cli)
  • Shell aliases for find and grep are unaliased first to avoid conflicts
  • A tip in the system prompt mentions: "When using find -regex with alternation, put the longest alternative first"
Evidence

Shell shadowing setup (search for "unalias find 2>/dev/null") — e6Y at line ~245057. Feature gate (search for "EMBEDDED_SEARCH_TOOLS")

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

See this entry in the whole of v2.1.71 →