search
Search local files and code with four modes: intelligent LLM ranking, structured symbol-aware queries, context gathering, or filename matching.
Instructions
Unified search (intelligent|structured|gather|filenames). root defaults to "." when omitted.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action: intelligent (LLM ranking), structured (symbol-aware), gather (collect relevant files), filenames (find files/dirs by name/path) | |
| query | Yes | Search query or context description | |
| root | No | OPTIONAL: Root directory to search. Defaults to "." (workspace root) when omitted. Use "." explicitly or specify a subdirectory path like "src/" to narrow scope. | |
| filePattern | No | Filter by file glob pattern (intelligent action) | |
| targetType | No | Filter by symbol type (structured action) | |
| languages | No | Languages to search (structured action) | |
| path | No | Path for context gathering (gather action) | |
| scope | No | Context scope (gather action) | |
| strategy | No | Context strategy (gather action) | |
| maxFiles | No | Maximum files to analyze (gather action) | |
| maxResults | No | Maximum results (default: 20) | |
| includeHidden | No | Include hidden files/directories (filenames action, default: false) | |
| includeDirectories | No | Include directory matches in results (filenames action, default: false) | |
| includePatterns | No | File patterns to include (e.g., ["*.py", "src/**"]). If set, only matching files are searched. | |
| excludePatterns | No | File patterns to exclude (e.g., ["venv/**", "node_modules/**"]). Uses smart defaults if not specified. | |
| format | No | Output format: compact (paths only), dense (minimal), detailed (full), json (raw) | |
| deterministic | No | If true, disable LLM ranking for exhaustive exact-match results (slower but complete) |