Sagar Patil 1abf04cb01 tmux: add README (#7293) 6 years ago
..
README.md 1abf04cb01 tmux: add README (#7293) 6 years ago
tmux.extra.conf bf40d4e354 Adding helper tmux config files to tmux plugin. 11 years ago
tmux.only.conf bf40d4e354 Adding helper tmux config files to tmux plugin. 11 years ago
tmux.plugin.zsh ff6b4c835b tmux: do not auto-load tmux inside of Emacs/Vim 6 years ago

README.md

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
ts tmux new-session -s Create a new named tmux session
tl tmux list-sessions Displays a list of running tmux sessions
tksv tmux kill-server Terminate all running tmux sessions
tkss tmux kill-session -t Terminate named running tmux session
tmux _zsh_tmux_plugin_run Start a new tmux session

Configuration Variables

Variable Description
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_FIXTERM Sets $TERM to 256-color term or not based on current terminal support
ZSH_TMUX_ITERM2 Sets the -CC option for iTerm2 tmux integration (default: false)
ZSH_TMUX_FIXTERM_WITHOUT_256COLOR $TERM to use for non 256-color terminals (default: screen)
ZSH_TMUX_FIXTERM_WITH_256COLOR $TERM to use for 256-color terminals (default: screen-256color