> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # ls - List files in the image List files and directories in the session image without spawning a sandbox. ## Examples ```bash theme={null} # List root directory contree ls / # List a specific directory contree ls /etc/nginx # JSON output with file metadata contree -f json ls /usr/bin ``` ## Help output

\$ contree ls --help

usage: contree ls \[-h] \[path]

List files in the session image.

Uses the /inspect/ API to list directory contents without spawning an
instance. Defaults to the session working directory (set via \`cd\`).

In default format, the API returns a pre-formatted text listing. In
structured formats (json, csv, etc.) the response is cached per
(image, path) for instant repeat queries.

positional arguments:
  path        Path inside image (defaults to session cwd)

options:
  -h, --help  show this help message and exit

for coding agents:
  read-only command (inspect API, no instance spawn)
  defaults to session cwd when PATH is omitted
  use -f json for cacheable structured listings

agent note:
  Before using this command in an automated workflow, read:
    contree agent

## Output Each entry shows path, size, permissions (octal), owner, group, modification time, and type (`d` for directory, `l` for symlink, `-` for file). This command reads the image filesystem directly – no sandbox is started and no resources are consumed. ## See also * [cat - Show file content from the image](./cat) – view file contents * [cp - Download a file from the image](./cp) – download a file locally * [Your First Sandbox](../tutorial/first-steps) – inspecting the filesystem