blender_list_files
List files and directories in Blender projects to manage assets and navigate file systems, with options for recursive searches and hidden files.
Instructions
List files and directories in the Blender project or specified directory.
Provides comprehensive file system overview for project management and asset organization.
Args:
directory_path (optional): Directory path to list (relative to project)
recursive (boolean, default false): Include subdirectories recursively
include_hidden (boolean, default false): Include hidden files and directories
Returns: File listing with metadata including sizes, types, and modification times
Examples:
Current directory: directory_path="", recursive=false
Recursive list: directory_path="assets", recursive=true
Include hidden: directory_path=".", include_hidden=true
Use when: Project organization, asset management, file system navigation Don't use when: Creating new files or directories (use create_directory/save_file)
Performance: Fast operation, minor impact with large recursive listings
Security: Only accesses files within project directory structure
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| directory_path | No | Directory path to list (default: current project) | |
| recursive | No | Include subdirectories recursively | |
| include_hidden | No | Include hidden files and directories |