Managing Plugins

tpack binds three key combinations in tmux for the core plugin lifecycle. Each opens the TUI with the corresponding operation pre-selected.

Discovering plugins

Open the TUI with ++prefix+shift+t++ and press B to browse a curated plugin registry. You can filter by category with Tab and search by name with /. Select a plugin and press I to install it — the plugin line is added to your tmux.conf automatically.

See Interactive TUI — Browse Screen for the full keybinding reference.

Installing plugins

1. Add a plugin line to your tmux config:

   set -g @plugin 'tmux-plugins/tmux-sensible'
   

2. Press ++prefix+shift+i++ (capital I, as in Install).

3. The plugin is cloned to ~/.tmux/plugins/ and sourced automatically.

Tip

You can also install plugins directly from the browse screen without manually editing your config.

Updating plugins

Press ++prefix+shift+u++ to update plugins. The TUI opens and you can select which plugins to update.

Uninstalling plugins

1. Remove (or comment out) the plugin line from your tmux config.

2. Press ++prefix+alt+u++ (lowercase u, as in uninstall).

3. The orphaned plugin directory is removed.

Tip

All three key bindings can be customized. See Key Bindings for details.