tmux-fzf
Blazing-fast project and session switching for tmux, powered by fzf.
Dependencies
Required
- fzf
- fd
Optional
- gh - Enables opening GitHub repositories from the picker
- gum - Highlights upterm sessions in the session picker
- tmux-upterm - Enables opening projects in upterm
Installation
Add this plugin to your ~/.tmux.conf:
set -g @plugin 'tmux-contrib/tmux-fzf'And install it by running <prefix + I.
Usage
| Key Binding | Description | | ----------------------------------------------- | ----------------------------- | | <kbdPrefix</kbd + <kbdf</kbd + <kbdp</kbd | Search and switch to projects | | <kbdPrefix</kbd + <kbdf</kbd + <kbds</kbd | Search and switch to sessions |
Project Picker
- Select a project directory to create or switch to a session
- Press <kbdCtrl</kbd+<kbdO</kbd to open the project's GitHub repository in the browser
- Press <kbdCtrl</kbd+<kbdT</kbd to open the project in upterm (if available)
Session Picker
- Select a session to switch to it
- Press <kbdCtrl</kbd+<kbdO</kbd to open the session's GitHub repository in the browser
- Press <kbdCtrl</kbd+<kbdX</kbd to kill the highlighted session
- Press <kbdSpace</kbd for jump mode