# 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/latest/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/).

## Parameters

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

## Example

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