Interactive TUI¶
Opening the TUI¶
Press ++prefix+shift+t++ to open the TUI. On tmux 3.2+ it launches in a popup window. On older versions it opens inline in the current pane.
Plugin List¶
The default screen shows all declared plugins and their status (Installed, Not Installed, Outdated, Checking). Select plugins with Space or Tab, then trigger an operation.
Progress View¶
Displayed during install, update, or clean operations. Shows real-time per-plugin progress with a progress bar and status indicators. After completion, use Up / Down to browse results and Enter to view commits for updated plugins.
Commit History¶
After an update, select a result and press Enter to see the recent commits pulled in for that plugin. Press Esc to return to the progress view.
Browse Screen¶
Press B on the plugin list to open the browse screen. It fetches a curated plugin registry and displays available plugins with star counts and descriptions. Plugins already in your configuration are marked as "(installed)".
Category filtering¶
A category bar at the top shows all available categories. Press Tab to cycle through them. The default view shows all plugins.
Searching¶
Press / to enter search mode. Type to filter plugins by name or description in real time. Press Enter to accept the filter or Esc to revert to the previous query.
Installing from browse¶
Select a plugin and press I to install it. The plugin line is automatically added to your tmux.conf and installation begins immediately — no manual config editing required.
Opening a plugin URL¶
Press Enter on a plugin to open its GitHub page in your browser. The URL is also copied to the clipboard.
Debug View¶
Press ++at++ on the plugin list to open the debug screen. Displays tpack version, binary path, and configuration details useful for troubleshooting.
Navigation reference¶
Plugin list¶
| Key | Action |
|---|---|
| Up / K | Move cursor up |
| Down / J | Move cursor down |
| Space / Tab | Toggle selection |
| I | Install selected / not-installed plugins |
| U | Update selected / installed plugins |
| C | Clean orphaned plugin directories |
| X | Uninstall selected plugins |
| B | Open browse screen |
| ++at++ | Open debug view |
| Q | Quit |
| Ctrl+C | Force quit |
Browse screen¶
| Key | Action |
|---|---|
| Up / K | Move cursor up |
| Down / J | Move cursor down |
| / | Search / filter plugins |
| Tab | Cycle category |
| I | Install selected plugin |
| Enter | Open plugin URL in browser |
| Esc | Go back to plugin list |
| Q | Quit |
Progress view¶
| Key | Action |
|---|---|
| Up / Down | Browse results |
| Enter | View commits for the selected result |
| Esc | Go back to plugin list |