tmux-project

Search projects and open them in a new session.

Prequisites

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

Install

Installation with tpm (recommended)

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

Customization

Variable	Default value	Description
@project-key	"g"	The key to invoke the project search. If you set it to "", the key is disabled.
@project-base-dirs	""	A comma-separated list of directories and their depths to search for projects.
@project-rooters	".git"	A comma-separated list of rooters.
@project-fzf-tmux-layout-opts	""	The layout options for fzf-tmux. See fzf-tmux(1) for details.
@project-fzf-opts	"--preview 'ls {}'"	The options for fzf. See fzf(1) for details.

Setting @project-base-dirs

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

tmuxinator Integration

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.

License

MIT