list_dir

Scan and retrieve non-gitignored files and directories from a specified path, optionally with recursion. Outputs results as a JSON object for easy integration and analysis.

Instructions

Lists all non-gitignored files and directories in the given directory (optionally with recursion). Returns a JSON object with the names of directories and files within the given directory.

Input Schema

Name	Required	Description
`max_answer_chars`	No	If the output is longer than this number of characters, no content will be returned. Don't adjust unless there is really no other way to get the content required for the task.
`recursive`	Yes	Whether to scan subdirectories recursively.
`relative_path`	Yes	The relative path to the directory to list; pass "." to scan the project root.

Input Schema (JSON Schema)

{
  "properties": {
    "max_answer_chars": {
      "default": 200000,
      "description": "If the output is longer than this number of characters,\nno content will be returned. Don't adjust unless there is really no other way to get the content\nrequired for the task.",
      "title": "Max Answer Chars",
      "type": "integer"
    },
    "recursive": {
      "description": "Whether to scan subdirectories recursively.",
      "title": "Recursive",
      "type": "boolean"
    },
    "relative_path": {
      "description": "The relative path to the directory to list; pass \".\" to scan the project root.",
      "title": "Relative Path",
      "type": "string"
    }
  },
  "required": [
    "relative_path",
    "recursive"
  ],
  "title": "applyArguments",
  "type": "object"
}

Serena

list_dir

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Serena

Related Tools

MCP directory API