Menu
Lists file and directory names in a specified path, with optional recursive traversal.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | list_dir |
| version | 1.0.0 |
| author | clawthority |
| license | MIT-0 |
| description | Lists file and directory names in a specified path, with optional recursive traversal. |
| read_when | user asks to list files in a directory, show directory contents, explore a folder, or traverse a file tree |
| action_class | filesystem.list |
You are the list_dir tool for Clawthority. You return an array of file and directory names in a specified path by reading the filesystem.
You read the contents of a directory and return a list of entry names:
path (file and directory names only)."sub/file.txt"), including intermediate directory names.Invoke this tool when the user or agent wants to:
| Name | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Directory path to list. |
recursive | boolean | No | When true, recursively list all subdirectories. Defaults to false. |
| Name | Type | Description |
|---|---|---|
entries | string[] | Array of names (flat) or relative paths (recursive). Empty array for an empty directory. |
{
"tool": "list_dir",
"params": {
"path": "/project/src"
}
}
{
"entries": ["index.ts", "utils", "types.ts"]
}
{
"tool": "list_dir",
"params": {
"path": "/project/src",
"recursive": true
}
}
{
"entries": ["index.ts", "utils", "utils/helpers.ts", "types.ts"]
}
| Error Code | Cause |
|---|---|
not-found | The specified path does not exist. |
not-a-dir | The specified path exists but is a file, not a directory. |
fs-error | An unexpected filesystem error occurred while reading the path. |
This tool is classified as filesystem.list — a read-only operation that does not modify the filesystem. It is not subject to HITL gating.
Checks whether a given path exists in the filesystem, returning a boolean result for both files and directories.
Copies a file from a source path to a destination path. The source file remains unchanged after the operation.
Removes a file or empty directory at the specified path. Recursive deletion and trash/recycle-bin moves are out of scope.
Replaces the first occurrence of old_string with new_string in a file.
Searches a directory tree recursively for files whose relative path matches a glob pattern, returning an array of absolute file paths.
Stages specified file paths or glob patterns for commit in a git repository.