list_dir
Scan and retrieve all non-gitignored files and directories in a specified path, optionally with recursion, returning structured JSON output. Part of the Serena MCP Server for enhanced codebase management.
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 | Default |
|---|---|---|---|
| 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"
}