jade.grep
Read-only
Search workspace files by literal text or regex, returning path:line matches with optional trailing context. Use for strings, fields, errors, or config keys; supports multiple patterns and path filters.
Instructions
Literal or regex text search across the workspace, returning path:line matches with optional trailing context — the replacement for grep -rn. Use this for anything that is not a declaration name: struct fields, string literals, error messages, config keys, or any search needing a path filter. Use find instead when you want a declaration and its body. Pass queries to search several patterns in one call.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| glob | No | Restrict by path, e.g. *.go or internal/code/*. | |
| limit | No | Maximum matches returned (default 40). The true total is always reported. Prefer budget. | |
| query | No | Text to find. | |
| regex | No | Treat query as a regular expression. grep-style \| alternation and \( \) groups work as in grep. | |
| budget | No | Size of the answer in tokens. Cut at whole matches; the rest is behind continue=<handle>. | |
| context | No | Trailing lines to show per match, like grep -A (max 40). | |
| exclude | No | Skip paths containing this substring, e.g. testdata. | |
| queries | No | Several patterns in one call, instead of query. Each is answered as query would be, with the same filters. | |
| continue | No | Handle from a cut answer: its next page. Other arguments except budget are ignored. | |
| dependency | No | Search this dependency's source instead of the workspace, read-only, at the version the project locks: a crate, Go module, npm or Python package name. Matches read as dep:<name>/<path>, which read_range accepts. | |
| ignoreCase | No | Case-insensitive match. |