# tmuxp.cli.ls.command_ls

- **Module:** tmuxp.cli.ls
- **Package:** tmuxp
- **Language:** Python
- **Kind:** function
- **Source:** https://github.com/tmux-python/tmuxp/blob/153acdf6ff1268b14d3d03ed488f545a7123c8f1/src/tmuxp/cli/ls.py#L553
- **Page:** https://libtmux.org/en/py/stable/workspace/reference/tmuxp-cli-ls-command_ls/

```
tmuxp.cli.ls.command_ls(
    args: CLILsNamespace | None = None,
    parser: argparse.ArgumentParser | None = None,
) -> None
```

Entrypoint for ``tmuxp ls`` subcommand.

Lists both local workspaces (from cwd and parent directories) and
global workspaces (from ~/.tmuxp/).

## Examples

```python
>>> # command_ls() lists workspaces from cwd/parents and ~/.tmuxp/
```

## Parameters

- `args` (`CLILsNamespace | None`): Parsed command-line arguments.
- `parser` (`argparse.ArgumentParser | None`): The argument parser (unused but required by CLI interface).