# List saved workspaces

Source: https://libtmux.org/en/py/stable/workspace/cli/ls/

> List the workspace files found in project and global configuration locations.

List discovered project and saved workspace files, with optional grouping and
configuration content.

## List records

```console
$ tmuxp ls --json
```

JSON output is an object with `workspaces` and `global_workspace_dirs`. No
workspaces produces an empty `workspaces` array. `--ndjson` emits one record per
line and zero lines for an empty result; it takes precedence when both output
flags are present.

`--full` includes configuration content. `--tree` groups human output by
directory. [Discovery](https://libtmux.org/en/py/stable/workspace/guides/discovery/) explains the locations searched.

[Command source](https://github.com/tmux-python/tmuxp/blob/618b398acc05506d3c682906c36cdeb29dcfa1ff/src/tmuxp/cli/ls.py).