Telescope-tmux.nvim
A Telescope.nvim extension for fuzzy-finding over tmux targets.
Prerequisites
- tmux
- Neovim nightly
- telescope.nvim
- nvim-terminal.lua (for displaying terminal colors in the
pane_contentspreviewer)
Commands
Sessions
Switch to another tmux session
:Telescope tmux sessions| Mapping | Description | Modes |
|---|---|---|
<C-a> |
Create new session | n,i |
<C-d> |
Delete a session | n,i |
<C-r> |
Rename a session | n,i |
| Option | Description | Default value |
|---|---|---|
entry_format |
A tmux format string used to determine how to display the session entry | #S |
Windows
Switch to another window
:Telescope tmux windows| Mapping | Description | Modes |
|---|---|---|
<C-d> |
Delete a window | n,i |
| Option | Description | Default value |
|---|---|---|
entry_format |
A tmux format string used to determine how to display the window entry | #S: #W |
Pane Contents
Find something in a pane's history scrollback
:Telescope tmux pane_contentsUse with tmux display-popup
Tmux 3.2's new display-popup command is a neat way to access the telescope picker when you are outside of Neovim.
Add the following commands to your .tmux.conf which override the default tmux session and window pickers to use telescope.
# use telescope-tmux for picking sessions and windows
bind s display-popup -E -w 80% -h 80% nvim -c ":Telescope tmux sessions quit_on_select=true"
bind w display-popup -E -w 80% -h 80% nvim -c ":Telescope tmux windows quit_on_select=true"