Home

Awesome

Telescope-tmux.nvim

A Telescope.nvim extension for fuzzy-finding over tmux targets.

demo

Prerequisites

Commands

Sessions

Switch to another tmux session

:Telescope tmux sessions
MappingDescriptionModes
<C-a>Create new sessionn,i
<C-d>Delete a sessionn,i
<C-r>Rename a sessionn,i
OptionDescriptionDefault value
entry_formatA tmux format string used to determine how to display the session entry#S

Windows

Switch to another window

:Telescope tmux windows
MappingDescriptionModes
<C-d>Delete a windown,i
OptionDescriptionDefault value
entry_formatA 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_contents

Use 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"