tpack - A Tmux Plugin Manager

Full Documentation

A modern tmux plugin manager written in Go. Drop-in replacement for TPM — fully backward compatible with existing TPM configurations, plugins, and key bindings.

Works on Linux, macOS, and FreeBSD.

Installation

Requirements: tmux version 1.9 (or higher), git, bash.

Homebrew (macOS / Linux)

brew install tmuxpack/tpack/tpack

AUR (Arch Linux)

yay -S tpack-bin

DEB / RPM (Debian, Ubuntu, Fedora, etc.)

Download the latest .deb or .rpm package from the releases page and install it with your package manager:

# Debian / Ubuntu
sudo dpkg -i tpack_*.deb

# Fedora / RHEL
sudo rpm -i tpack_*.rpm

Git clone

git clone https://github.com/tmuxpack/tpack ~/.tmux/plugins/tpm

Build from source

git clone https://github.com/tmuxpack/tpack
cd tpack
make build
# Binary is at dist/tpack

Quick start

Add to ~/.tmux.conf (or $XDG_CONFIG_HOME/tmux/tmux.conf):

# List of plugins
set -g @plugin 'tmuxpack/tpack'
set -g @plugin 'tmux-plugins/tmux-sensible'

# Initialize tpack (keep this line at the very bottom of tmux.conf)
run '~/.tmux/plugins/tpm/tpm'

Reload tmux and press prefix + I to install plugins:

tmux source ~/.tmux.conf

See the Getting Started guide for full setup instructions.

Features

• Drop-in TPM replacement — no config changes needed when switching from TPM
• Interactive TUI — browse, install, update, and uninstall plugins visually (prefix + T)
• CLI — tpack install, tpack update, tpack clean, and more
• Automatic updates — optional background update checking for plugins and tpack itself
• Customizable — key bindings, colors, plugin directory, and update behavior
• Plugins browser — search, brose and install plugins from the TUI, the list being maintained on the plugins-registry

See the full documentation for details on configuration, usage, and the CLI reference.

Migrating from TPM

tpack is a drop-in replacement for TPM. Two ways to switch:

• Git remote — if you git cloned TPM, just point the remote at tpack and pull. No tmux.conf changes needed:

  cd ~/.tmux/plugins/tpm
  git remote set-url origin https://github.com/tmuxpack/tpack
  git pull

• Package manager — install tpack via Homebrew, AUR, DEB/RPM, or go install, then replace the run line in your tmux.conf with run 'tpack init'.

See the full migration guide for details.

Acknowledgments

tpack is built on the foundations of TPM, the original Tmux Plugin Manager created by Bruno Sutic. Thanks to Bruno and the TPM contributors for establishing the plugin ecosystem that tpack is designed to be compatible with.

License

MIT