Zsh plugin for Tmux

September 2, 2026 ยท View on GitHub

A small plugin for Tmux. It will setup the TERM variable, and will start tmux automaticaliy when you login via SSH and will show motd in the first window.

Autostart happens only when you login via SSH. Set TMUX_AUTOSTART=true to enable it on a local host as well, or TMUX_AUTOSTART=false to disable it completely. Motd display can be disabled by setting TMUX_MOTD=false

You can preserve your default TERM value by setting the variable TMUX_OVERRIDE_TERM=false. It can be useful to get truecolors working properly in neovim.

Example

PROMPT='$pr_node ...REST OF PROMPT'

This plugin is made to be fast. It runs in background and updates information only when needed.

Installation

If you use oh-my-zsh

  • Clone this repository into ~/.oh-my-zsh/custom/plugins
cd ~/.oh-my-zsh/custom/plugins
git clone https://github.com/zpm-zsh/tmux
  • After that, add tmux to your oh-my-zsh plugins array.

If you use Zgen

  1. Add zgen load zpm-zsh/tmux to your .zshrc with your other plugin
  2. run zgen save

If you use my ZPM

  • Add zpm load zpm-zsh/tmux into your .zshrc