File Search
Tool name: search_files
Searches your local file system by filename pattern, with wildcard support. Ideal for digging up project files like PSD or Blend inside a folder, or batch-listing all assets of a given type.
When to use it
- You can't find a particular PSD or Blend file in a project folder
- You need to batch-organize assets of a certain type
- You want to list every image under a specific folder while archiving
How to use it
Through Agent chat
- "Find all the PSD files in my Documents"
- "List every image under the reference folder"
- "Pull up any file with backup in its name"
The Agent turns your description into a wildcard pattern and runs the search. By default it starts from your Documents folder (~/Documents), but you can also point it at other locations under your home directory.
技巧
File search is currently only available through Agent chat; there is no standalone entry in the toolbox.
Common search patterns
| Pattern | What it matches |
|---|---|
**/*.psd | All PSD files |
*.png | All PNGs in the current directory |
ref/**/* | Everything inside the ref folder and its subfolders |
project_*.jpg | JPGs starting with project_ |
**/*backup* | Any file whose name contains backup, at any depth |
Reading the results
Matches come back as a list, containing files only, not folders. Each result shows the relative path and the file size. By default it returns 10 results at a time, up to a maximum of 50; when there are more, results are paginated and the Agent can keep flipping to the next page.
Limits and caveats
The search is confined to your personal home directory (~); any path outside it is blocked for safety. This means:
- It cannot access Windows system directories
- It cannot access the Nephele install directory
- It cannot access other users' home directories
- Drive locations outside your home directory (for example, searching the D: drive directly) are also out of scope
注意
The search starts from your Documents folder by default. If you want to search other locations under your home directory, specify them explicitly in the search path.