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

# ls

> List repository files, branches, and workspaces using the Diversion ls command for quick project overview.

```bash theme={null}
dv ls <ref_id> <output>
```

This command lists the file system contents of a: workspace, branch or commit.

`<ref_id>` is the ID of the revision to list. The default is list the current workspace revision.

`<output>` is an optional file to plot the results to, by default will print to the standard output.