Search projects and open them in a new session.

• find
• fzf (needs fzf-tmux to be installed)

Add the following line to your .tmux.conf.

set -g @plugin 'sei40kr/tmux-project'

It is also recommended to add the following line to your .tmux.conf to prevent a client from being detached when the active session is destroyed.

set detach-on-destroy no-detached

@project-base-dirs is a comma-separated list of directories and their depths to search for projects.

Each element of the list is in the following format:

/path/to/dir[:<min depth>[:<max depth>]]

• If you omit <min depth> and <max depth>, they are set to 0 and 0 respectively.
• If you omit <max depth>, it is set to <min depth>. (means <min depth> is the exact depth)

If you omit the depth or explicitly set it to 0, the directory itself will be added as a project. In that case, you can add the directory as a project even if it contains no rooter.

For example, if you want to search for ghq repositories as projects:

set -ag @project-base-dirs ,"${GHQ_ROOT}:3"

For example, if you want to add ~/.vim itself as a project:

set -ag @project-base-dirs ,"${HOME}/.vim"

tmux-project can be integrated with tmuxinator. When you have tmuxinator installed and the selected project has .tmuxinator.yml at the root, tmux-project will start a new session with tmuxinator.

MIT