https://github.com/viniarck/tmuxdir.nvim
:open_file_folder: :zap: tmux session workspace plugin for nvim
https://github.com/viniarck/tmuxdir.nvim
denite-source neovim tmux workspace-plugin
Last synced: 8 months ago
JSON representation
:open_file_folder: :zap: tmux session workspace plugin for nvim
- Host: GitHub
- URL: https://github.com/viniarck/tmuxdir.nvim
- Owner: viniarck
- License: apache-2.0
- Archived: true
- Created: 2018-11-03T20:11:35.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-30T21:25:35.000Z (almost 2 years ago)
- Last Synced: 2024-08-07T18:43:21.347Z (11 months ago)
- Topics: denite-source, neovim, tmux, workspace-plugin
- Language: Python
- Homepage:
- Size: 62.5 KB
- Stars: 20
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
tmuxidir is a tmux session workspace plugin for nvim.
## Deprecation Notice
`tmuxdir.nvim` is no longer actively maintained, you should use [`telescope-tmuxdir` instead](https://github.com/viniarck/telescope-tmuxdir.nvim).
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_session` for tmux sessions.
- Denite source `tmux_dir` for 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_session` and `:Denite tmux_dir`
## Installation
**Note:** tmuxdir requires [denite.nvim](https://github.com/Shougo/denite.nvim), pynvim, Neovim 0.3+ and Python3.6+
- If you use **dein**:
```viml
call dein#add('viniarck/tmuxdir.nvim')
call dein#add('Shougo/denite.nvim')
```
- If you use **vim-plug**:
```viml
Plug 'viniarck/tmuxdir.nvim', { 'do': ':UpdateRemotePlugins' }
Plug 'Shougo/denite.nvim'
```
## TLDR basic config
```viml
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](doc/tmuxdir.txt) out.
## How to use
- Tmux sessions:
```
:Denite tmux_session
```
- Tmux project directories:
```
:Denite tmux_dir
```
## Docs / Release Notes
[tmuxdir.txt](./doc/tmuxdir.txt)