Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 2.67 KB

README.md

File metadata and controls

79 lines (52 loc) · 2.67 KB

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