tmux-plugins/tpm

Analysis updated 2026-06-24

★ 14,678ShellAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((tpm))
    Inputs
      tmux conf
      Plugin list
      Git URLs
    Outputs
      Installed plugins
      Loaded tmux env
      Updated plugins
    Use Cases
      Manage tmux plugins
      Sync setup across machines
      Install from custom Git host
    Tech Stack
      Bash
      tmux
      Git

mindmap root((tpm)) Inputs tmux conf Plugin list Git URLs Outputs Installed plugins Loaded tmux env Updated plugins Use Cases Manage tmux plugins Sync setup across machines Install from custom Git host Tech Stack Bash tmux Git

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Install and update tmux plugins listed in your tmux.conf with a single shortcut

USE CASE 2

Replicate a tmux plugin setup on a new machine by copying tmux.conf

USE CASE 3

Pull a tmux plugin from a specific Git branch or self-hosted Git URL

USE CASE 4

Auto-install plugins on first tmux launch for dotfile bootstrap scripts

What is it built with?

BashtmuxGit

How does it compare?

	tmux-plugins/tpm	sorin-ionescu/prezto	winapps-org/winapps
Stars	14,678	14,529	15,016
Language	Shell	Shell	Shell
Last pushed	—	—	2026-05-16
Maintenance	—	—	Maintained
Setup difficulty	easy	easy	hard
Complexity	2/5	2/5	4/5
Audience	developer	developer	ops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The run ~/.tmux/plugins/tpm/tpm line must stay at the very bottom of tmux.conf or plugins will not load.

MIT lets you use, modify, and ship this in commercial products as long as you keep the copyright notice.

In plain English

TPM stands for Tmux Plugin Manager. Tmux is a tool used in the terminal that lets a developer split one window into several panes, keep sessions running in the background, and switch between them quickly. People extend tmux with plugins, and TPM is the small program that installs and loads those plugins for you, so you do not have to download and configure each one by hand. The README says TPM has been tested on Linux, macOS, and Cygwin, and that it needs tmux version 1.9 or higher, plus Git and Bash. A separate list of available plugins is maintained at the tmux-plugins/list repository on GitHub. Installation is a one-time setup. You clone the TPM repository into the directory ~/.tmux/plugins/tpm, then add a small block of configuration to the bottom of your tmux config file, usually at ~/.tmux.conf. That block lists the plugins you want to use, each one written as set -g @plugin followed by its GitHub repository name. The last line, run ~/.tmux/plugins/tpm/tpm, must stay at the very bottom of the file so TPM is started after the plugin list is read. The README also accepts plugins from a specific branch, from arbitrary Git URLs, and from Bitbucket. After editing the file, you reload the tmux configuration with tmux source ~/.tmux.conf. Once TPM is set up, managing plugins is done with keyboard shortcuts. The tmux prefix key followed by capital I installs any new plugins listed in the config and refreshes the environment. The prefix followed by capital U updates installed plugins. The prefix followed by Alt and lowercase u removes any plugins that are no longer in the list. All plugins live under ~/.tmux/plugins/, so a user can also remove a plugin directory by hand if they prefer. The documentation folder covers help for when TPM is not working, instructions for writing your own plugin, managing plugins from the command line, changing the install directory, and setting up TPM automatically on a new machine. Tests run on Travis CI and can also be run locally with Vagrant. The project is released under the MIT License.

Copy-paste prompts

Prompt 1

Give me a 5-minute install guide for tpm and a tmux.conf with three useful plugins

Prompt 2

Show me the tmux.conf block that loads tmux-resurrect and tmux-continuum via tpm

Prompt 3

Write a dotfiles install script that clones tpm and installs plugins headlessly on a fresh machine

Prompt 4

How do I pin a tpm-managed plugin to a specific branch or fork

Prompt 5

Explain what prefix + I, prefix + U, and prefix + alt + u do in tpm

Frequently asked questions

What is tpm?

Plugin manager for tmux that installs, updates, and removes plugins declared in your tmux.conf with a few prefix-key shortcuts.

What language is tpm written in?

Mainly Shell. The stack also includes Bash, tmux, Git.

What license does tpm use?

MIT lets you use, modify, and ship this in commercial products as long as you keep the copyright notice.

How hard is tpm to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tpm for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.