# Shell completion

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

> Generate completion for the installed workspace command.

tmuxp uses the optional `shtab` package to generate experimental shell completion
from its argparse definitions. Install it in the same Python environment as
tmuxp, then follow the [completion setup](https://tmuxp.git-pull.com/cli/completion/)
for your shell.

Generate the script again after upgrading tmuxp so it matches the installed
parser. The parser is available through [`tmuxp.cli.create_parser`](<https://libtmux.org/en/py/stable/workspace/reference/tmuxp-cli-create_parser/>).

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