search_codebase

Auto-generated from the registered MCP tool descriptions and input schemas. Do not edit by hand — run pnpm docs:tools to regenerate.

Cross-file search across an index of declared symbol NAMES over the working directory — declarations only, NOT usages, call-sites, comments, or string content. Use when you need to find where a symbol is declared across MANY files. Not an AST parser — for single-file structure use extract_symbols.

Parameters

Parameter Type Required Constraints Description
query string yes minLength 1; maxLength 200 Search query (symbol name, keyword, or pattern)
directory string no minLength 1; maxLength 500 Directory to search (default: current working directory)
limit number no min 1; max 50 Max results (default: 20)
mode enum no one of: search | summary | list search: find symbols. summary: file overview. list: list indexed files.
maxDepth integer no min 1; max 64 Max directory depth to index below “directory” (default: 24, clamped to 64). Raise this if results seem incomplete for a deeply nested tree.