tmuxp 1.17+ (experimental)¶

Provisional support for completions in tmuxp 1.17+ are powered by shtab. This must be installed separately, as it’s not currently bundled with tmuxp.

$ pip install shtab --user

With a uv project you can add it directly as a development dependency:

Or reach for uvx when you want a pipx-style ephemeral install:

$ shtab --shell=bash -u tmuxp.cli.create_parser \
  | sudo tee "$BASH_COMPLETION_COMPAT_DIR"/TMUXP

$ shtab --shell=zsh -u tmuxp.cli.create_parser \
  | sudo tee /usr/local/share/zsh/site-functions/_TMUXP

$ shtab --shell=tcsh -u tmuxp.cli.create_parser \
  | sudo tee /etc/profile.d/TMUXP.completion.csh

tmuxp 1.1 to 1.16¶

tmuxp 1.1 to 1.16 use click’s completion:

eval "$(_TMUXP_COMPLETE=bash_source tmuxp)"

eval "$(_TMUXP_COMPLETE=zsh_source tmuxp)"