tmuxdir.nvim
tmuxdir.nvim copied to clipboard
:open_file_folder: :zap: tmux session workspace plugin for nvim
tmuxidir is a tmux session workspace plugin for nvim.
Deprecation Notice
tmuxdir.nvim is no longer actively maintained, you should use telescope-tmuxdir instead.
It turns out that denite.nvim is no longer actively maintained (and developed), so I've replaced it with telescope, which has a strong and active ecosystem of plugins.
tmuxdir workflow
- You can manage tmux sessions and projects from nvim.
- A project directory is identified with a root marker (folder or file) in a set of base directories (e.g.,
~/repos/). - Each project is mapped to a tmux session, so a tmux session acts as a workspace.
- You can have additional tmux sessions mapped to the same project if you want.
Features
- Denite source
tmux_sessionfor tmux sessions. - Denite source
tmux_dirfor tmux project directories. - Any folder can also be statically bookmarked as a project
TmuxdirAdd(dir). - Automatically discover new projects once a root marker is found.
Screencast
:Denite tmux_sessionand:Denite tmux_dir

Installation
Note: tmuxdir requires denite.nvim, pynvim, Neovim 0.3+ and Python3.6+
- If you use dein:
call dein#add('viniarck/tmuxdir.nvim')
call dein#add('Shougo/denite.nvim')
- If you use vim-plug:
Plug 'viniarck/tmuxdir.nvim', { 'do': ':UpdateRemotePlugins' }
Plug 'Shougo/denite.nvim'
TLDR basic config
let g:tmuxdir_base_dirs = ['~/repos', '~/projects', '~/src'] " Set of base directories to look for your projects
let g:tmuxdir_root_markers = ['.git'] " root markers to identify projects
For more information, key bindings, and available functions, check doc/tmuxdir.txt out.
How to use
- Tmux sessions:
:Denite tmux_session
- Tmux project directories:
:Denite tmux_dir
Docs / Release Notes
tmuxdir.txt