search_files
Search for files and directories recursively by matching a pattern, starting from a specified path. Returns full paths to matches, supporting case-insensitive and partial name searches. Automatically excludes unwanted items and operates within secure directory boundaries.
Instructions
Recursively search for files and directories matching a pattern. Searches through all subdirectories from the starting path. The search is case-insensitive and matches partial names. Returns full paths to all matching items. Great for finding files when you don't know their exact location. Only searches within allowed directories.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| excludePatterns | No | Patterns to exclude from search results | |
| path | Yes | Root path to start searching from | |
| pattern | Yes | Pattern to match against filenames and directories |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"excludePatterns": {
"default": [],
"description": "Patterns to exclude from search results",
"items": {
"type": "string"
},
"type": "array"
},
"path": {
"description": "Root path to start searching from",
"type": "string"
},
"pattern": {
"description": "Pattern to match against filenames and directories",
"type": "string"
}
},
"required": [
"path",
"pattern"
],
"type": "object"
}