[semantic]
Literal/regex text search over the workspace for comments, strings, config-like text, or non-symbol text. Delegates to the scout universal index (install scout to enable); returns a structured install hint when scout is absent.
Literal and regex text hunts (comments, strings, config) need repo-wide coverage that compiler-backed symbol tools do not provide.
The model gets scout-backed, ignore-aware, exhaustive text search with paging instead of shell grep, and a structured install hint when scout is missing.
Try it locally in the TGlider playground
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search text or pattern. |
| useRegex | boolean | No | Treat query as a regex (Rust regex dialect via the scout backend). Default is false. |
| caseSensitive | boolean | No | Case-sensitive match. Default is false. |
| scope | json | No | Optional scope: pathPrefix (workspace-relative) and globs (prefix with ! to exclude). |
| skip | number | No | Pagination offset. Default is 0. |
| take | number | No | Pagination size. Default is 50, maximum 200. |
| maxLineTextChars | number | No | Max characters of preview per match. Use 0 for the scout backend's cap. Default is 200. |
| pathStyle | string | No | Path style: 'relative' (to the workspace root, default) or 'absolute'. |
Find TODO comments across the workspace
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_text",
"arguments": {
"query": "TODO"
}
}
}Returns scout-backed matches (filePath, line, column, preview) with paging (including totalIsFloor), exhaustive, and hints. Errors carry code scout_not_installed with install commands when scout is absent.