find
Search the local code index for symbols by case-insensitive substring, returning name, file, and line to pin down the exact symbol for call graph queries.
Instructions
Search the local corbel index for symbols whose name matches a query, for when you don't know the exact symbol name to pass to get_symbol. Matching is substring-based and case-insensitive, ranked so exact name matches come first, then names starting with the query, then names merely containing it; within each of those tiers results are ordered by name, then file, then line for a stable, repeatable order. Case-insensitivity only folds ASCII letters (SQLite's default LIKE behavior) — it will not match differently-cased Unicode identifiers (e.g. a Python or JavaScript identifier using non-ASCII letters), so queries against such names must match the identifier's actual case. Each match reports name, file, and line, which together are the exact triple get_symbol needs to pin down that one symbol even when several symbols elsewhere share its name. This tool does not resolve or return call relationships — use get_symbol or impact on a specific match for that. The response can be truncated to fit within limit and a token budget; when it is, truncated is set to true and truncated_count reports how many further matches were left out. Results come from the local corbel index built by corbel index and only reflect the repository as of the last index run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional cap on the number of matches returned, from 0 up to corbel's hard maximum of 200 (requests above 200 are rejected, not silently reduced). Defaults to corbel's built-in limit if omitted. | |
| query | Yes | Substring to search for in symbol names (case-insensitive for ASCII). | |
| token_budget | No | Optional cap on the size of the response, in estimated tokens. Defaults to corbel's built-in budget if omitted. |