> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List files

> Directory listing tool that shows files and subdirectories in a tree structure, helping you explore and understand the project organization.

{/* Tool: list_directory */}

## Parameters

<ParamField path="path" type="string" required={true}>
  The absolute path to the directory to list.
</ParamField>

<ParamField path="ignore" type="string[]" default={[]}>
  List of glob patterns to ignore.
</ParamField>

<ParamField path="device" type="string" default={""}>
  Optional fleet device name or id. When set, lists a directory inside that running device's container instead of the host (requires `python` in the device image). The device must be started first. Requires the 'devices:manage' scope.
</ParamField>

<ParamField path="zapp" type="string" default={""}>
  Optional Zo App slug or id. When set, lists a directory inside that Zo App's sandbox instead of the host. Mutually exclusive with 'device'. Requires the 'apps:shell' scope.
</ParamField>