search_files

Locate files and directories by name pattern recursively within a specified directory. Supports case-insensitive searches, excludes hidden items by default, and returns relative paths. Ideal for organizing and accessing project files efficiently.

Instructions

Search for files and directories matching a pattern. The search is recursive and case-insensitive. Only searches within the allowed directory. Returns paths relative to the allowed directory. Searches in file and directory names, not content. For searching within file contents, use the tree_sitter_map tool which can locate specific code elements like functions and classes. Example: pattern='.py' finds all Python files, pattern='test' finds all items with 'test' in the name.

Input Schema

Name	Required	Description
`include_hidden`	No	Whether to include hidden files and directories (defaults to false)
`path`	No	Starting directory for the search (defaults to allowed directory)
`pattern`	Yes	Pattern to search for in file and directory names

Input Schema (JSON Schema)

{
  "properties": {
    "include_hidden": {
      "description": "Whether to include hidden files and directories (defaults to false)",
      "type": "boolean"
    },
    "path": {
      "description": "Starting directory for the search (defaults to allowed directory)",
      "type": "string"
    },
    "pattern": {
      "description": "Pattern to search for in file and directory names",
      "type": "string"
    }
  },
  "required": [
    "pattern"
  ],
  "type": "object"
}

AiDD MCP Server

search_files

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from AiDD MCP Server

Related Tools