Skip to content

tpack

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

Works on Linux, macOS, and FreeBSD.

Features

  • Drop-in TPM Replacement

    Switch without changing your tmux.conf. All existing TPM settings, plugin declarations, and key bindings continue to work.

  • Interactive TUI

    Browse, install, update, and clean plugins with a built-in terminal UI. Launches in a tmux popup on 3.2+.

  • Plugin Registry

    Discover plugins from a curated registry. Search by name, filter by category, and install with a single key press — no manual config editing required.

  • Automatic Updates

    Background plugin update checking with three modes: prompt, auto, or off. Self-update support for the tpack binary itself.

  • Multiple Install Methods

    Available via Homebrew, AUR, deb/rpm packages, git clone, or build from source.

Quick Start

Install tpack and add it to your tmux config:

# Install (macOS / Linux)
brew install tmuxpack/tpack/tpack

# ~/.tmux.conf
set -g @plugin 'tmux-plugins/tmux-sensible'

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

Clone tpack and add it to your tmux config:

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

# ~/.tmux.conf
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+shift+i++ to install plugins:

tmux source ~/.tmux.conf

See the installation guide for all install methods.