tmux

This plugin provides aliases for tmux, the terminal multiplexer. To use it add tmux to the plugins array in your zshrc file.

plugins=(... tmux)

The plugin also supports the following:

• determines if tmux is installed or not, if not, prompts user to install tmux
• determines if the terminal supports the 256 colors or not, sets the appropriate configuration variable
• sets the correct local config file to use

Aliases

| Alias | Command | Description | | ---------- | -------------------------- | -------------------------------------------------------- | | ta | tmux attach -t | Attach new tmux session to already running named session | | tad | tmux attach -d -t | Detach named tmux session | | tds | _tmux_directory_session | Creates or attaches to a session for the current path | | tkss | tmux kill-session -t | Terminate named running tmux session | | tksv | tmux kill-server | Terminate all running tmux sessions | | tl | tmux list-sessions | Displays a list of running tmux sessions | | to | tmux new-session -A -s | Create or attach to a named tmux session | | tmux | _zsh_tmux_plugin_run | Start a new tmux session | | tmuxconf | $EDITOR $ZSH_TMUX_CONFIG | Open .tmux.conf file with an editor | | ts | tmux new-session -s | Create a new named tmux session |

Configuration Variables

| Variable | Description | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | ZSH_TMUX_AUTOREFRESH | Automatically refresh global environments (default: false) | | ZSH_TMUX_AUTOSTART | Automatically starts tmux (default: false) | | ZSH_TMUX_AUTOSTART_ONCE | Autostart only if tmux hasn't been started previously (default: true) | | ZSH_TMUX_AUTOCONNECT | Automatically connect to a previous session if it exits (default: true) | | ZSH_TMUX_AUTOQUIT | Automatically closes terminal once tmux exits (default: ZSH_TMUX_AUTOSTART) | | ZSH_TMUX_CONFIG | Set the configuration path (default: $HOME/.tmux.conf, $XDG_CONFIG_HOME/tmux/tmux.conf) | | ZSH_TMUX_DEFAULT_SESSION_NAME | Set tmux default session name when autostart is enabled | | ZSH_TMUX_AUTONAME_SESSION | Automatically name new sessions based on the basename of $PWD (default: false) | | ZSH_TMUX_DETACHED | Set the detached mode (default: false) | | ZSH_TMUX_FIXTERM | Sets $TERM to 256-color term or not based on current terminal support | | ZSH_TMUX_FIXTERM_WITHOUT_256COLOR | $TERM to use for non 256-color terminals (default: tmux if available, screen otherwise) | | ZSH_TMUX_FIXTERM_WITH_256COLOR | $TERM to use for 256-color terminals (default: tmux-256color if available, screen-256color otherwise) | | ZSH_TMUX_ITERM2 | Sets the -CC option for iTerm2 tmux integration (default: false) | | ZSH_TMUX_UNICODE | Set tmux -u option to support unicode |