List files
list_filesBrowse a workspace directory tree to confirm paths exist or inspect files and folders, with adjustable depth, entry limits, and optional ignored folders.
Instructions
List files and directories (depth 1-3, limit up to 200). include_ignored=true also lists ignored folders. Use when: you need the directory tree or want to confirm a path exists. Avoid when: you know the file (read_file) or want what changed lately (recent_files). Output: entries[] {relative_path, kind, size_bytes}, truncated.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Tree depth (default 1, max 3). | |
| limit | No | Max entries (default 200, max 200). | |
| relative_path | No | Workspace-relative ('.' = root); absolute/.. outside it rejected. | |
| include_ignored | No | true also lists ignored folders (default false). |