get_project_files
Discover a Godot project's file tree when paths are unknown. List the whole project or one subfolder, filter by file extensions.
Instructions
Return the file tree of a Godot project. Use to discover project structure when paths are unknown. subfolder lists one folder as the root (maxDepth counts from it). extensions filters files (e.g. ["gd","tscn"]) and drops directories with no match; maxDepth -1 is unlimited. Skips dot-prefixed entries. Returns: the root node { name, type, path, children[] }; a child is a file, a directory, or a link (not followed). A directory not opened or unreadable has children null; warnings leads then.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectPath": "<projectPath>"
},
"name": "get_project_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxDepth | No | Maximum recursion depth, counted from the listed root. -1 means unlimited (default: -1) | |
| subfolder | No | Folder inside the project to list instead of the whole project (e.g. "ui/themes" or "res://ui"). Must exist and be a directory. Omit for the project root. | |
| extensions | No | Filter to only these file extensions (e.g. ["gd", "tscn"]); directories with no match are left out. Omit to include all. | |
| projectPath | Yes | Path to the Godot project directory |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| path | Yes | Project-relative path; "." for the root. | |
| type | Yes | ||
| children | No | Directories only. Each child has this same shape. Null when the directory was not opened (maxDepth) or could not be read. | |
| warnings | No | Root node only: depth cuts, unreadable paths and links that were not followed. | |
| extension | No | Files only, lower case, no dot. |