Full Documentation - Mostly AI-generated

A modern tmux plugin manager written in Go. It accepts existing TPM configuration syntax and key bindings, while adding repository-aware plugin management.

Works on Linux, macOS, and FreeBSD.

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

There are two ways to set up tpack, each with different installation methods and configuration.

Install tpack as a binary on your $PATH. This is the recommended approach for new setups.

brew install tmuxpack/tpack/tpack

brew install tpack

yay -S tpack-bin

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

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

go install github.com/tmuxpack/tpack/cmd/tpack@latest

git clone https://github.com/tmuxpack/tpack
cd tpack
make build
# Binary is at dist/tpack — move it somewhere on your $PATH
sudo cp dist/tpack /usr/local/bin/

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

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

# Initialize tpack (keep this line at the very bottom of tmux.conf)
run 'tpack init'

Clone tpack into the TPM directory. Existing TPM declaration syntax remains valid, so no tmux.conf syntax changes are needed when switching from TPM. The plugin directory migration described above still applies.

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

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

# List of plugins
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.

• TPM-compatible configuration — existing declarations and key bindings work
• Interactive TUI — browse, install, update, remove, 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, browse and install plugins from the TUI, the list being maintained on the plugins-registry

Not interested in a whole category of plugins (e.g. ai)? Hide it from the browser with @tpack-hidden-categories:

set -g @tpack-hidden-categories 'ai'

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

tpack accepts TPM configuration syntax. 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 (see installation guide), then replace the run line in your tmux.conf with run 'tpack init'.

See the full migration guide for details.

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.

MIT