search_codebase
Find code by concept, symbol, or path using hybrid search that automatically routes queries to the appropriate method.
Instructions
Find code by concept, symbol, or path — hybrid codebase search.
mode="auto" (default) routes the query: identifier-shaped queries search
the indexed symbols (returns symbol_id/file/line bounds — pipe into
get_symbol), path-shaped queries resolve files (pipe into get_context),
and conceptual queries ("rate limiting", "where do we handle webhooks")
run wiki-semantic search. Mixed natural-language + identifier queries run
hybrid (symbol hits first, then concept pages). Concept results carry
search_method ("embedding" or "bm25" fallback: verify those); decision
records rank below file pages unless the query is why-shaped.
Args:
query: identifier, path, or natural-language query.
limit: max results (default 5).
page_type: file_page | module_page | symbol_spotlight (concept only).
kind: implementation | test | config | doc (concept/symbol modes).
repo: alias, or "all" for workspace-wide.
mode: auto | concept | symbol | path | hybrid.
symbol_kind: filter symbol hits by kind (function|class|method|...).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| mode | No | auto | |
| repo | No | ||
| limit | No | ||
| query | Yes | ||
| page_type | No | ||
| symbol_kind | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |