tmux workspaces

A plugin to interactively select workspaces and create tmux sessions for them.

Prerequisites

Please check the following packages are installed on your system:

• tmux
• bash
• fzf

Installation

With tpm

Add the plugin to your tmux.conf like so

set -g @plugin 'jdtron/tmux-workspaces'

If you already have a running session, press prefix + I to install the plugin.

Manual

Clone this repository into the tmux plugins directory (~/.tmux/plugins or ~/.config/tmux/plugins).
Load plugin.tmux in your tmux.conf.

Configuration

Configuration is done through the usage of tmux options.

Option	Default	Description
@workspaces-root	~/workspaces	Workspaces root directory
@workspaces-main-enabled	true	Enable a main session
@workspaces-main-session	MAIN	Main session name (for executing tmuxw -m directly)
@workspaces-key	O	Keybinding to trigger tmuxw
@workspaces-chooser-width	40	Width of the workspace chooser
@workspaces-chooser-display	left	Display as split left/right or popup
@workspaces-select-nested	true	Select nested workspaces sequentially, rather than in a flat list

Example

set -g @workspaces-root '/home/jd/code'
set -g @workspaces-main-session 'BASE'
set -g @workspaces-key 'X'
run '~/.config/tmux/plugins/workspaces/plugin.tmux'