tmux-sidebar does one thing: it opens a tree directory listing for the current
path. It's fast, convenient and works great with vim.
Some of the features that make the plugin more appealing than doing the same thing manually each time:
Much faster than doing each step manually.
- smart sizing
Sidebar remembers its size, so the next time you open it, it will have the exact same width. This is a per-directory property, so you can have just the right size for multiple dirs.
The same key binding opens and closes the sidebar.
- uninterrupted workflow
prefix + Tabkey binding opens a sidebar but does not move cursor to it.
- pane layout stays the same
No matter which pane layout you prefer, sidebar tries hard not to mess your pane splits. Open, then close the sidebar and everything should look the same.
tmux 1.9 or higher,
tree recommended but not required
Tested and working on Linux, OSX and Cygwin.
prefix + Tab- toggle sidebar with a directory tree
prefix + Backspace- toggle sidebar and move cursor to it (focus it)
Tmux Plugin Manager (recommended)Installation with
Add plugin to the list of TPM plugins in
set -g @plugin 'tmux-plugins/tmux-sidebar'
prefix + I to fetch the plugin and source it. You should now be able to
use the plugin.
Clone the repo:
$ git clone https://github.com/tmux-plugins/tmux-sidebar ~/clone/path
Add this line to the bottom of
Reload TMUX environment:
# type this in terminal $ tmux source-file ~/.tmux.conf
You should now be able to use the plugin.
- tmux-copycat - a plugin for regex searches in tmux and fast match selection
- tmux-resurrect - restore tmux environment after a system restart