explore
Search codebases with natural-language questions to locate where specific features are implemented, returning a summary and matched file:line references instead of raw contents.
Instructions
Natural-language search across the codebase: combines grep-style matching with optional LLM summarization to answer 'where is X handled?' or 'what files implement Y?' Returns a summary + the matching file:line list, not raw file contents. Use when you DON'T already know which file to look at. For a deep analysis of ONE known file, use analyze_file. For a structured question across a known set of files (glob patterns), use batch_analyze. depth:'shallow' is fast grep; depth:'deep' adds LLM-generated context per match. Read-only: walks the filesystem and reads matched files but never writes. Returns: {success, summary (LLM- or template-generated answer), files_found:[paths], search_patterns:[strings actually grepped], evidence:[...] (capped at 15), tokens_saved, processing_time_ms, depth, backend_used}. The evidence entry shape depends on depth: shallow returns {file, line, snippet} per matching line; deep returns {file, matches:[{line, context}]}, grouping each file's matches with surrounding context.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | ||
| question | Yes | Natural language question about the codebase (e.g., "where is user authentication handled?") |