list_files
Browse an Obsidian vault filesystem with ls-style listing, showing file sizes and modification times. Supports glob patterns and recursive subfolder traversal, hiding dot-directories.
Instructions
Browse the vault filesystem (ls-style), including non-markdown files.
Peer to list_notes, which lists indexed markdown only; list_files reads
the filesystem directly and reports sizes so you can gauge a binary before
read_file.
By default lists the immediate children of folder — subdirectories and
files, each file with size and modification time. pattern is a glob that
filters file entries (e.g. "*.pdf"); recursive=True descends into
subfolders and returns matching files. Dot-directories (.obsidian,
.git, .trash, …) are hidden, and a dot-directory folder is rejected.
At most limit entries are returned (default 200, hard cap 1000); the
response indicates when the listing was truncated.
Args: folder: Vault-relative folder (default "." = vault root). pattern: Glob applied to file names (default "*"). recursive: If True, descend into subfolders. Off by default. limit: Maximum entries to return (default 200, hard cap 1000).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| folder | No | . | |
| pattern | No | * | |
| recursive | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |