Troubleshooting

tmuxp command not found

Ensure tmuxp is installed and on your PATH:

$ which tmuxp

If installed with pip install --user, ensure ~/.local/bin is in your PATH.

tmux server not found

tmuxp requires a running tmux server or will start one automatically. Ensure tmux is installed:

$ tmux -V

Minimum required version: tmux 3.2a.

Configuration errors

Use tmuxp debug-info to collect system information for bug reports:

$ tmuxp debug-info

Session already exists

If a session with the same name already exists, tmuxp will prompt you. Use tmuxp load -d to load in detached mode alongside existing sessions.

Shell completion not working

See Shell Completion for setup instructions for bash, zsh, and fish.