Search files
search_filesFinds text in a file or folder, returning file:line matches with optional context; use file masks or regex to narrow results and skip heavy or binary files by default.
Instructions
Search text in one file or across the files of a folder on this computer (path may point to either). Returns file:line matches with optional surrounding context. Heavy folders (node_modules, .git, dist, build, ...) are excluded by default, binary files are skipped. Use include ('*.ts') to narrow by file mask and regex=true for regular expressions. Always reports the true match count.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Short human-readable explanation (1 line, in the user's language) of what you are about to do and why. Shown to the user on the approval card. Always provide when calling mutating tools. | |
| path | No | ||
| agent | No | Short consistent identifier or display name of this agent (e.g. 'Claude · Лендинг', 'Тесты', 'Мой агент'). Used to separate tasks and route tray messages when multiple agents work in parallel. | |
| query | Yes | ||
| regex | No | ||
| include | No | ||
| ignoreCase | No | ||
| maxResults | No | ||
| contextLines | No | ||
| includeIgnored | No |