list_files
Lists a folder. Default is vault.
Lists a folder. Default is vault.
- Tool name
- list_files
- Group
- Files
- Risk
- none
- Needs approval
- never
- Approval rule
- Read only.
- Allowed in scheduled jobs
- Yes
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| directory | string | No | vault | Folder to list. |
Returns
File names.
Example (made up for this page)
{}a.md
b.mdSide effects
- none
How it can fail
| When | What the agent sees |
|---|---|
| Folder missing | Directory not found |
See also:Files tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.