find_file

Locate non-gitignored files matching a specified file mask within a given directory. Returns a JSON list of matching files for efficient file discovery.

Instructions

Finds non-gitignored files matching the given file mask within the given relative path. Returns a JSON object with the list of matching files.

Input Schema

Name	Required	Description	Default
`file_mask`	Yes	The filename or file mask (using the wildcards * or ?) to search for.
`relative_path`	Yes	The relative path to the directory to search in; pass "." to scan the project root.

Input Schema (JSON Schema)

{
  "properties": {
    "file_mask": {
      "description": "The filename or file mask (using the wildcards * or ?) to search for.",
      "title": "File Mask",
      "type": "string"
    },
    "relative_path": {
      "description": "The relative path to the directory to search in; pass \".\" to scan the project root.",
      "title": "Relative Path",
      "type": "string"
    }
  },
  "required": [
    "file_mask",
    "relative_path"
  ],
  "title": "applyArguments",
  "type": "object"
}

Serena

find_file

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Serena

Related Tools

MCP directory API