wip(commands): re-implement core commands as bash functions

Re-implement all libexec executables as bash functions, with the goal of
being able build a single standalone execuable bash script for
tmuxifier.

.travis.yml

@@ -8,7 +8,7 @@ env:
 before_install:
   - sudo apt-get update
   - sudo apt-get install -y bc build-essential libevent-dev libncurses5-dev
-  - wget http://downloads.sourceforge.net/tmux/tmux-${TMUX_VERSION}.tar.gz
+  - wget https://github.com/tmux/tmux/releases/download/${TMUX_VERSION}/tmux-${TMUX_VERSION}.tar.gz
   - tar -zxf tmux-${TMUX_VERSION}.tar.gz
   - cd tmux-${TMUX_VERSION}
   - ./configure && make && sudo make install

README.md

@@ -3,18 +3,18 @@
 Tmuxify your Tmux. Create, edit, manage and load complex Tmux session, window
 and pane configurations with ease.
 
-In short, Tmuxifier allows you to easily create, edit, and load "layout"
-files, which are simple shell scripts where you use the `tmux` command and
-helper commands provided by `tmuxifier` to manage Tmux sessions and windows
+In short, Tmuxifier allows you to easily create, edit, and load "layout" files,
+which are simple shell scripts where you use the `tmux` command and helper
+commands provided by `tmuxifier` to manage Tmux sessions and windows
 
 ### Window Layouts
 
-Window layouts create a new Tmux window, optionally setting the window title
-and root path where all shells are cd'd to by default. It allows you to easily
-split a window into specifically sized panes and more as you wish.
+Window layouts create a new Tmux window, optionally setting the window title and
+root path where all shells are cd'd to by default. It allows you to easily split
+a window into specifically sized panes and more as you wish.
 
-You can load a window layout directly into your current Tmux session, or into
-a session layout to have the window created along with the session.
+You can load a window layout directly into your current Tmux session, or into a
+session layout to have the window created along with the session.
 
 ### Session Layouts
 
@@ -25,10 +25,11 @@ defined directly within the session layout file.
 
 ## Example
 
-Given we have a window layout file called [example.window.sh][] which
-looks like:
+Given we have a window layout file called [example.window.sh][] which looks
+like:
 
-[example.window.sh]: https://github.com/jimeh/tmuxifier/blob/master/examples/example.window.sh
+[example.window.sh]:
+  https://github.com/jimeh/tmuxifier/blob/master/examples/example.window.sh
 
 ```bash
 window_root "~/Desktop"
@@ -39,8 +40,8 @@ split_h 60
 select_pane 0
 ```
 
-You can then load that window layout into a new window in the
-current tmux session using:
+You can then load that window layout into a new window in the current tmux
+session using:
 
     tmuxifier load-window example
 
@@ -50,6 +51,8 @@ Which will yield a Tmux window looking like this:
 
 ## Installation
 
+### Manual
+
 Clone the repo to your machine:
 
     git clone https://github.com/jimeh/tmuxifier.git ~/.tmuxifier
@@ -57,33 +60,49 @@ Clone the repo to your machine:
 Then add `$HOME/.tmuxifier/bin` to your PATH to make the `tmuxifier` executable
 available to you:
 
-__In bash & zsh:__
+**In bash & zsh:**
 
 ```bash
 export PATH="$HOME/.tmuxifier/bin:$PATH"
 ```
 
-__In tcsh:__
+**In tcsh:**
 
 ```tcsh
 set path = ( "~/.tmuxifier/bin" $path )
 ```
 
-__In fish:__
+**In fish:**
 
 ```bash
 set -gx PATH "~/.tmuxifier/bin" $PATH
 ```
 
-### Custom Installation Path
+#### Custom Installation Path
 
 To install Tmuxifier somewhere else than the suggested `~/.tmuxifier`, simply
 clone the repository to your custom location, and ensure the `bin` folder is
 added to your PATH making the `tmuxifier` executable available to you.
 
+### TPM
+
+You can also install and update Tmuxifier with
+[TPM](https://github.com/tmux-plugins/tpm):
+
+```bash
+set -g @plugin 'jimeh/tmuxifier'
+```
+
+Trigger TPM's install command with `prefix` + `I` to install Tmuxifier to TPM's
+plugin directory (default is `$HOME/.tmux/plugins`).
+
+To use the `tmuxifier` command, you will need to add the `bin` directory to your
+PATH. If you are using the default TPM plugin directory, the `bin` directory
+will be `$HOME/.tmux/plugins/tmuxifier/bin`.
+
 ## Setup
 
-__In bash & zsh:__
+**In bash & zsh:**
 
 And add the following to your `~/.profile`, `~/.bash_profile`, `~/.zshrc` or
 equivalent:
@@ -92,7 +111,7 @@ equivalent:
 eval "$(tmuxifier init -)"
 ```
 
-__In tcsh:__
+**In tcsh:**
 
 Add the following to your `~/.cshrc`, `~/.tcshrc` or equivalent:
 
@@ -100,19 +119,19 @@ Add the following to your `~/.cshrc`, `~/.tcshrc` or equivalent:
 eval `tmuxifier init -`
 ```
 
-__In fish:__
+**In fish:**
 
 And add the following to your `~/.config/fish/config.fish` or equivalent:
 
 ```bash
-eval (tmuxifier init -)
+eval (tmuxifier init - fish)
 ```
 
 ### Custom Tmux Arguments
 
-If you need to pass custom arguments to `tmux` itself, you can do so by
-setting the `TMUXIFIER_TMUX_OPTS` environment variable. For example to set
-custom arguments globally:
+If you need to pass custom arguments to `tmux` itself, you can do so by setting
+the `TMUXIFIER_TMUX_OPTS` environment variable. For example to set custom
+arguments globally:
 
 ```bash
 export TMUXIFIER_TMUX_OPTS="-L my-awesome-socket-name"
@@ -134,7 +153,7 @@ git pull
 
 ## Usage
 
-*__Note:__ This section needs expanding upon.*
+_**Note:** This section needs expanding upon._
 
 For a quick reference on available commands and their aliases, please run:
 
@@ -142,8 +161,8 @@ For a quick reference on available commands and their aliases, please run:
 
 Tmuxifier doesn't come with any layouts, so you'll want to create your own
 window and session layout files. New layout files are populated with examples
-and comments explaining what things do. Also, having a look at the
-[examples][] directory will also give you a good idea.
+and comments explaining what things do. Also, having a look at the [examples][]
+directory will also give you a good idea.
 
 ### Window Layouts
 
@@ -151,16 +170,16 @@ First off you'll want to define a window layout:
 
     tmuxifier new-window my-awesome-window
 
-This will create a new layout file called `my-awesome-window.window.sh` in
-your `$TMUXIFIER_LAYOUT_PATH`, and open it with the editor defined in
-`$EDITOR`. Customize it as you wish, and save.
+This will create a new layout file called `my-awesome-window.window.sh` in your
+`$TMUXIFIER_LAYOUT_PATH`, and open it with the editor defined in `$EDITOR`.
+Customize it as you wish, and save.
 
-You can now load *my-awesome-window* with the following command:
+You can now load _my-awesome-window_ with the following command:
 
     tmuxifier load-window my-awesome-window
 
-You should now have a new Tmux window open created from your custom and
-awesome window layout.
+You should now have a new Tmux window open created from your custom and awesome
+window layout.
 
 ### Session Layouts
 
@@ -170,8 +189,9 @@ To create your first session layout, run:
 
 Same deal as with creating a new window, except the filename ends with
 `.session.sh` instead of `.window.sh`, and the file's pre-populated content
-looks different. To have your awesome window loaded, add `load_window
-"my-awesome-window"` to the session layout next to existing examples.
+looks different. To have your awesome window loaded, add
+`load_window "my-awesome-window"` to the session layout next to existing
+examples.
 
 To load the session layout simply run:
 
@@ -195,8 +215,8 @@ export TMUXIFIER_LAYOUT_PATH="$HOME/.tmux-layouts"
 
 ### Disable Shell-Completion
 
-Tmuxifier comes with shell-completion for bash, zsh, tcsh, and fish. If for
-any reason you need to disable it, just set `$TMUXIFIER_NO_COMPLETE`.
+Tmuxifier comes with shell-completion for bash, zsh, tcsh, and fish. If for any
+reason you need to disable it, just set `$TMUXIFIER_NO_COMPLETE`.
 
 ```bash
 export TMUXIFIER_NO_COMPLETE=1
@@ -208,13 +228,12 @@ export TMUXIFIER_NO_COMPLETE=1
 
 Tmuxifier supports iTerm2's [Tmux integration][]. It can be used in two ways:
 
-- Passing `-CC` as a second argument to the `load-session` command. For
-example:
+- Passing `-CC` as a second argument to the `load-session` command. For example:
 
-        tmuxifier load-session my-awesome-session -CC
+          tmuxifier load-session my-awesome-session -CC
 
-- Setting the `TMUXIFIER_TMUX_ITERM_ATTACH` environment variable to `-CC`
-  before calling the `load-session` command.
+- Setting the `TMUXIFIER_TMUX_ITERM_ATTACH` environment variable to `-CC` before
+  calling the `load-session` command.
 
 [tmux integration]: https://gitlab.com/gnachman/iterm2/wikis/TmuxIntegration
 
@@ -226,16 +245,16 @@ example:
 
 ## Tmuxifier vs. Tmuxinator
 
-Though Tmuxifier is largely inspired by the excellent [Tmuxinator][] project,
-it does set itself apart in a number of ways:
+Though Tmuxifier is largely inspired by the excellent [Tmuxinator][] project, it
+does set itself apart in a number of ways:
 
-- Uses shell scripts to define Tmux sessions and windows instead of YAML
-  files. The benefit is total control over Tmux, but the definition files are
-  more complicated to work with.
+- Uses shell scripts to define Tmux sessions and windows instead of YAML files.
+  The benefit is total control over Tmux, but the definition files are more
+  complicated to work with.
 - Instead of using a "project" concept, Tmuxifier uses a concept of "sessions"
   and "windows" just like Tmux itself. This allows you to load a whole session
-  with multiple pre-defined window configurations, or just load a single
-  window configuration into your existing session.
+  with multiple pre-defined window configurations, or just load a single window
+  configuration into your existing session.
 - Tmuxifier is a set of shell scripts, meaning it doesn't require Ruby to be
   installed on the machine.
 
@@ -244,8 +263,8 @@ it does set itself apart in a number of ways:
 
 ## Todos
 
-* Improve Readme, specially Usage section.
-* Write up a detailed reference for all available layout helper functions.
+- Improve Readme, specially Usage section.
+- Write up a detailed reference for all available layout helper functions.
 
 ## License
 
@@ -253,20 +272,19 @@ it does set itself apart in a number of ways:
 
 Copyright (c) 2014 Jim Myhrberg.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

bin/tmuxifier

@@ -3,11 +3,12 @@ set -e
 [ -n "$TMUXIFIER_DEBUG" ] && set -x
 
 resolve_link() {
-  $(type -p greadlink readlink | head -1) $1
+  $(type -p greadlink readlink | head -1) "$1"
 }
 
 abs_dirname() {
-  local cwd="$(pwd)"
+  local cwd
+  cwd="$(pwd)"
   local path="$1"
 
   while [ -n "$path" ]; do
@@ -20,48 +21,63 @@ abs_dirname() {
   cd "$cwd"
 }
 
-if [ -z "${TMUXIFIER}" ]; then
-  # Set TMUXIFIER relative to the "tmuxifier" executable.
-  export TMUXIFIER="$(dirname "$(abs_dirname "$0")")"
-else
-  # Strip any trailing slash (/) characters from TMUXIFIER variable.
-  export TMUXIFIER="${TMUXIFIER%/}"
-fi
+main() {
+  if [ -z "${TMUXIFIER}" ]; then
+    # Set TMUXIFIER relative to the "tmuxifier" executable.
+    export TMUXIFIER="$(dirname "$(abs_dirname "$0")")"
+  else
+    # Strip any trailing slash (/) characters from TMUXIFIER variable.
+    export TMUXIFIER="${TMUXIFIER%/}"
+  fi
 
-# Load tmuxifier environment variables.
-source "$TMUXIFIER/lib/env.sh"
+  # Bootstrap tmuxifier.
+  source "$TMUXIFIER/lib/load.sh"
 
-# Add tmuxifier's internal commands to PATH.
-export PATH="$TMUXIFIER/libexec:$PATH"
+  # Check Tmux version.
+  export TMUXIFIER_MIN_TMUX_VERSION="1.6"
+  if [ "$(tmuxifier-tmux-version "$TMUXIFIER_MIN_TMUX_VERSION")" == "<" ]; then
+    echo -e "ERROR: Tmuxifier requires Tmux v${TMUXIFIER_MIN_TMUX_VERSION}" \
+      "or newer. You have v$(tmuxifier-tmux-version)." >&2
+    exit 1
+  fi
 
-# Check Tmux version.
-export TMUXIFIER_MIN_TMUX_VERSION="1.6"
-if [ "$(tmuxifier-tmux-version "$TMUXIFIER_MIN_TMUX_VERSION")" == "<" ]; then
-  echo -e "ERROR: Tmuxifier requires Tmux v${TMUXIFIER_MIN_TMUX_VERSION}" \
-       "or newer. You have v$(tmuxifier-tmux-version)." >&2
-  exit 1
-fi
+  # Get command and shift arguments.
+  local command="$1"
+  shift 1
 
-# Parse given command
-command="$1"
-case "$command" in
-  "" | "-h" | "--help" )
-    echo -e "tmuxifier $(tmuxifier-version)\n$(tmuxifier-help)" >&2
-    ;;
+  # Resolve to full command name if an alias is given.
+  command="$(tmuxifier-alias "$command" || echo "$command")"
 
-  "-v" | "--version" )
-    tmuxifier-version
-    ;;
+  case "$command" in
+    "" | "-h" | "--help")
+      echo -e "tmuxifier $(tmuxifier-version)\n$(tmuxifier-help)" >&2
+      ;;
 
-  * )
-    ! command_path="$(tmuxifier-resolve-command-path "$command")"
+    "-v" | "--version")
+      tmuxifier-version
+      ;;
 
-    if [ -z "$command_path" ]; then
-      echo "tmuxifier: no such command '$command'" >&2
-      exit 1
-    fi
+    *)
+      local command_path
+      local func_name
 
-    shift 1
-    exec "$command_path" "$@"
-    ;;
-esac
+      func_name="tmuxifier-$command"
+
+      # Check if command is available as a function.
+      if declare -f "$func_name" > /dev/null; then
+        "$func_name" "$@"
+      else
+        # Fall back to libexec executable.
+        command_path="$(tmuxifier-resolve-command-path "$command")" || true
+        if [ -z "$command_path" ]; then
+          echo "tmuxifier: no such command '$command'" >&2
+          exit 1
+        fi
+
+        exec "$command_path" "$@"
+      fi
+      ;;
+  esac
+}
+
+main "$@"

completion/tmuxifier.bash

@@ -3,11 +3,11 @@ _tmuxifier() {
   local word="${COMP_WORDS[COMP_CWORD]}"
 
   if [ "$COMP_CWORD" -eq 1 ]; then
-    COMPREPLY=( $(compgen -W "$(tmuxifier commands)" -- "$word") )
+    COMPREPLY=($(compgen -W "$(tmuxifier commands)" -- "$word"))
   else
     local command="${COMP_WORDS[1]}"
     local completions="$(tmuxifier completions "$command")"
-    COMPREPLY=( $(compgen -W "$completions" -- "$word") )
+    COMPREPLY=($(compgen -W "$completions" -- "$word"))
   fi
 }
 

init.fish

@@ -11,7 +11,10 @@ end
 # If `tmuxifier` is available, and `$TMUXIFIER_NO_COMPLETE` is not set, then
 # load Tmuxifier shell completion.
 if test -n (which tmuxifier); and test -z $TMUXIFIER_NO_COMPLETE
-  source "$TMUXIFIER/completion/tmuxifier.fish"
+    # fish shell 2.0.0 does not have the source alias
+    if [ (fish --version 2>| awk -F'version ' '{print $2}') = '2.0.0' ];
+      . "$TMUXIFIER/completion/tmuxifier.fish"
+    else
+      source "$TMUXIFIER/completion/tmuxifier.fish"
+    end
 end
-
-

lib/commands/alias.sh

@@ -0,0 +1,56 @@
+# Resolve a tmuxifier command alias to its full command name.
+#
+# Usage:
+#   tmuxifier-alias <alias>
+#
+# Arguments:
+#   $1 - Alias to resolve
+#
+# Output:
+#   The full command name if alias is recognized, empty otherwise.
+#
+# Returns:
+#   0 - Alias was recognized
+#   1 - Alias was not recognized
+tmuxifier-alias() {
+  # Provide tmuxifier help
+  if calling-help "$@"; then
+    echo "usage: tmuxifier alias <alias>
+
+Resolve a command alias to it's full name."
+    return
+  fi
+
+  case "$1" in
+    "session" | "ses" | "s")
+      echo "load-session"
+      ;;
+    "window" | "win" | "w")
+      echo "load-window"
+      ;;
+    "new-ses" | "nses" | "ns")
+      echo "new-session"
+      ;;
+    "new-win" | "nwin" | "nw")
+      echo "new-window"
+      ;;
+    "edit-ses" | "eses" | "es")
+      echo "edit-session"
+      ;;
+    "edit-win" | "ewin" | "ew")
+      echo "edit-window"
+      ;;
+    "l")
+      echo "list"
+      ;;
+    "list-ses" | "lses" | "ls")
+      echo "list-sessions"
+      ;;
+    "list-win" | "lwin" | "lw")
+      echo "list-windows"
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+}

lib/commands/resolve-command-path.sh

@@ -0,0 +1,43 @@
+# Resolve the absolute path to a tmuxifier command or alias.
+#
+# Usage:
+#   tmuxifier-resolve-command-path <command_or_alias>
+#
+# Arguments:
+#   $1 - Command name or alias to resolve
+#
+# Output:
+#   The absolute path to the command executable, or empty if not found.
+#
+# Returns:
+#   0 - Command was found
+#   1 - Command was not found
+tmuxifier-resolve-command-path() {
+  # Provide tmuxifier help
+  if calling-help "$@"; then
+    echo "usage: tmuxifier resolve-command-path <command_or_alias>
+
+Outputs the absolute path to the given command or command alias."
+    return
+  fi
+
+  local command_path=""
+
+  if [ -n "$1" ]; then
+    # Look for executable file, not functions.
+    command_path="$(type -P "tmuxifier-$1" 2> /dev/null)" || true
+    if [ -z "$command_path" ]; then
+      local resolved
+      resolved="$(tmuxifier-alias "$1")"
+      if [ -n "$resolved" ]; then
+        command_path="$(type -P "tmuxifier-$resolved" 2> /dev/null)" || true
+      fi
+    fi
+  fi
+
+  if [ -n "$command_path" ]; then
+    echo "$command_path"
+  else
+    return 1
+  fi
+}

lib/commands/tmux-version.sh

@@ -0,0 +1,63 @@
+# Enable extended globbing for version string cleanup.
+shopt -s extglob
+
+# Output current Tmux version, or compare against a target version.
+#
+# Usage:
+#   tmuxifier-tmux-version             # Outputs current Tmux version
+#   tmuxifier-tmux-version "1.9"       # Outputs "=", "<", or ">"
+#
+# Arguments:
+#   $1 - Optional target version to compare against
+#
+# Output:
+#   Without arguments: The current Tmux version string
+#   With target version: One of "=", "<", or ">" indicating if the current
+#                        Tmux version is equal to, less than, or greater than
+#                        the target version.
+#
+# Returns:
+#   0 - Always succeeds
+tmuxifier-tmux-version() {
+  # Provide tmuxifier help
+  if calling-help "$@"; then
+    echo "usage: tmuxifier tmux-version [<target-version>]
+
+Outputs current Tmux version. If given optional target-version it outputs one
+of three possible characters indicating if the current Tmux version number is
+equal to, less than, or greater than the <target-version>.
+
+The three possible outputs are \"=\", \"<\", and \">\"."
+    return
+  fi
+
+  local version
+  version="$(tmux -V)"
+  version="${version/tmux /}"
+
+  # Fix for tmux next-* versions
+  version="${version/next-/}"
+
+  if [ -z "$1" ]; then
+    echo "$version"
+    return
+  fi
+
+  if [ "$version" == "master" ]; then
+    # When version string is "master", tmux was compiled from source, and we
+    # assume it's later than whatever the <target-version> is.
+    echo '>'
+  else
+    # Fix for "1.9a" version comparison, as vercomp() can only deal with
+    # purely numeric version numbers.
+    version="${version//+([a-zA-Z])/}"
+
+    local result
+    vercomp "$version" "$1" && result=$? || result=$?
+    case $result in
+      0) echo '=' ;;
+      1) echo '>' ;;
+      2) echo '<' ;;
+    esac
+  fi
+}

lib/layout-helpers.sh

@@ -37,7 +37,12 @@ new_window() {
 #   - $2: (optional) Target pane ID to split in current window.
 #
 split_v() {
-  if [ -n "$1" ]; then local percentage=(-p "$1"); fi
+  if [ "$(tmuxifier-tmux-version "3.0")" == ">" ]; then
+    # Tmux 3.1 and later.
+    if [ -n "$1" ]; then local percentage=(-l "$1"'%'); fi
+  else
+    if [ -n "$1" ]; then local percentage=(-p "$1"); fi
+  fi
   tmuxifier-tmux split-window -t "$session:$window.$2" -v "${percentage[@]}"
   __go_to_window_or_session_path
 }
@@ -49,7 +54,12 @@ split_v() {
 #   - $2: (optional) Target pane ID to split in current window.
 #
 split_h() {
-  if [ -n "$1" ]; then local percentage=(-p "$1"); fi
+  if [ "$(tmuxifier-tmux-version "3.0")" == ">" ]; then
+    # Tmux 3.1 and later.
+    if [ -n "$1" ]; then local percentage=(-l "$1"'%'); fi
+  else
+    if [ -n "$1" ]; then local percentage=(-p "$1"); fi
+  fi
   tmuxifier-tmux split-window -t "$session:$window.$2" -h "${percentage[@]}"
   __go_to_window_or_session_path
 }
@@ -105,6 +115,44 @@ select_pane() {
   tmuxifier-tmux select-pane -t "$session:$window.$1"
 }
 
+# Balance windows vertically with the "even-vertical" layout.
+#
+# Arguments:
+#   - $1: (optional) Window ID or name to operate on.
+#
+balance_windows_vertical() {
+  tmuxifier-tmux select-layout -t "$session:${1:-$window}" even-vertical
+}
+
+# Balance windows horizontally with the "even-horizontal" layout.
+#
+# Arguments:
+#   - $1: (optional) Window ID or name to operate on.
+#
+balance_windows_horizontal() {
+  tmuxifier-tmux select-layout -t "$session:${1:-$window}" even-horizontal
+}
+
+# Turn on synchronize-panes in a window.
+#
+# Arguments:
+#   - $1: (optional) Window ID or name to operate on.
+#
+synchronize_on() {
+  tmuxifier-tmux set-window-option -t "$session:${1:-$window}" \
+    synchronize-panes on
+}
+
+# Turn off synchronize-panes in a window.
+#
+# Arguments:
+#   - $1: (optional) Window ID or name to operate on.
+#
+synchronize_off() {
+  tmuxifier-tmux set-window-option -t "$session:${1:-$window}" \
+    synchronize-panes off
+}
+
 # Send/paste keys to the currently active pane/window.
 #
 # Arguments:
@@ -166,8 +214,8 @@ load_window() {
     if [ $# -gt 1 ]; then
       window="$2"
     else
-      window="${1/%.window.sh}"
-      window="${window/%.sh}"
+      window="${1/%.window.sh/}"
+      window="${window/%.sh/}"
     fi
     source "$file"
     window=
@@ -210,8 +258,8 @@ load_session() {
   if [ $# -gt 1 ]; then
     session="$2"
   else
-    session="${1/%.session.sh}"
-    session="${session/%.sh}"
+    session="${1/%.session.sh/}"
+    session="${session/%.sh/}"
   fi
 
   set_default_path=true
@@ -245,7 +293,7 @@ initialize_session() {
   tmuxifier-tmux start-server
 
   # Check if the named session already exists.
-  if tmuxifier-tmux has-session -t "$session:" 2>/dev/null; then
+  if tmuxifier-tmux list-sessions | grep -q "^$session:"; then
     return 1
   fi
 
@@ -260,7 +308,7 @@ initialize_session() {
 
       $set_default_path && tmuxifier-tmux \
         set-option -t "$session:" \
-        default-path "$session_root" 1>/dev/null
+        default-path "$session_root" 1> /dev/null
     fi
 
   # Tmux 1.9 and later.
@@ -296,13 +344,12 @@ initialize_session() {
 # created, but already existed, then we'll need to specifically switch to it.
 #
 finalize_and_go_to_session() {
-  ! tmuxifier-tmux kill-window -t "$session:999" 2>/dev/null
+  ! tmuxifier-tmux kill-window -t "$session:999" 2> /dev/null
   if [[ "$(tmuxifier-current-session)" != "$session" ]]; then
     __go_to_session
   fi
 }
 
-
 #
 # Internal functions
 #
@@ -320,7 +367,7 @@ __expand_path() {
 
 __get_first_window_index() {
   local index=$(tmuxifier-tmux list-windows -t "$session:" \
-    -F "#{window_index}" 2>/dev/null)
+    -F "#{window_index}" 2> /dev/null)
 
   if [ -n "$index" ]; then
     echo "$index" | head -1
@@ -331,10 +378,10 @@ __get_first_window_index() {
 
 __get_current_window_index() {
   local lookup=$(tmuxifier-tmux list-windows -t "$session:" \
-    -F "#{window_active}:#{window_index}" 2>/dev/null | grep "^1:")
+    -F "#{window_active}:#{window_index}" 2> /dev/null | grep "^1:")
 
   if [ -n "$lookup" ]; then
-    echo "${lookup/1:}"
+    echo "${lookup/1:/}"
   fi
 }
 
@@ -360,7 +407,7 @@ __go_to_window_or_session_path() {
 
   # local window_or_session_root=${window_root-$session_root}
   if [ -n "$target_path" ]; then
-    run_cmd "cd \"$target_path\""
-    run_cmd "clear"
+    run_cmd " cd \"$target_path\""
+    run_cmd " clear"
   fi
 }

lib/load.sh

@@ -0,0 +1,17 @@
+# Setup layout path.
+if [ -z "${TMUXIFIER_LAYOUT_PATH}" ]; then
+  export TMUXIFIER_LAYOUT_PATH="${TMUXIFIER}/layouts"
+else
+  export TMUXIFIER_LAYOUT_PATH="${TMUXIFIER_LAYOUT_PATH%/}"
+fi
+
+# Add tmuxifier's internal commands to PATH.
+export PATH="$TMUXIFIER/libexec:$PATH"
+
+# Load utility functions.
+source "$TMUXIFIER/lib/util.sh"
+
+# Load command functions from lib/commands/ directory directly.
+source "$TMUXIFIER/lib/commands/alias.sh"
+source "$TMUXIFIER/lib/commands/resolve-command-path.sh"
+source "$TMUXIFIER/lib/commands/tmux-version.sh"

lib/util.sh

@@ -1,11 +1,11 @@
 calling-help() {
-  if [[ " $@ " != *" --help "* ]] && [[ " $@ " != *" -h "* ]]; then
+  if [[ " $* " != *" --help "* ]] && [[ " $* " != *" -h "* ]]; then
     return 1
   fi
 }
 
 calling-complete() {
-  if [[ " $@ " != *" --complete "* ]]; then
+  if [[ " $* " != *" --complete "* ]]; then
     return 1
   fi
 }

libexec/tmuxifier-alias

@@ -1,46 +1,6 @@
 #! /usr/bin/env bash
-set -e
 [ -n "$TMUXIFIER_DEBUG" ] && set -x
 
-# Load internal utility functions.
-source "$TMUXIFIER/lib/util.sh"
+source "$TMUXIFIER/lib/load.sh"
 
-# Provide tmuxifier help
-if calling-help "$@"; then
-  echo "usage: tmuxifier alias <alias>
-
-Resolve a command alias to it's full name."
-  exit
-fi
-
-case "$1" in
-  "session" | "ses" | "s" )
-    echo "load-session"
-    ;;
-  "window" | "win" | "w" )
-    echo "load-window"
-    ;;
-  "new-ses" | "nses" | "ns" )
-    echo "new-session"
-    ;;
-  "new-win" | "nwin" | "nw" )
-    echo "new-window"
-    ;;
-  "edit-ses" | "eses" | "es" )
-    echo "edit-session"
-    ;;
-  "edit-win" | "ewin" | "ew" )
-    echo "edit-window"
-    ;;
-  "l" )
-    echo "list"
-    ;;
-  "list-ses" | "lses" | "ls" )
-    echo "list-sessions"
-    ;;
-  "list-win" | "lwin" | "lw" )
-    echo "list-windows"
-    ;;
-  * )
-    exit 1
-esac
+tmuxifier-alias "$@"

libexec/tmuxifier-commands

@@ -16,7 +16,8 @@ fi
 
 shopt -s nullglob
 
-{ for path in ${PATH//:/$'\n'}; do
+{
+  for path in ${PATH//:/$'\n'}; do
     for command in "${path}/tmuxifier-"*; do
       command="${command##*tmuxifier-}"
       echo "$command"

libexec/tmuxifier-completions

@@ -20,11 +20,11 @@ if calling-complete "$@"; then
 fi
 
 has-completions() {
-  grep -i "^# Provide tmuxifier completions" "$1" >/dev/null
+  grep -i "^# Provide tmuxifier completions" "$1" > /dev/null
 }
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help completions $@)" >&2
+  tmuxifier-help completions "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-current-session

@@ -14,8 +14,8 @@ Outputs the name of the current Tmux session."
 fi
 
 if [ -n "$TMUX" ]; then
-  for item in $(tmuxifier-tmux list-pane -F "#{session_name}");do
-    echo $item
+  for item in $(tmuxifier-tmux list-pane -F "#{session_name}"); do
+    echo "$item"
     exit 0
   done
 fi

libexec/tmuxifier-edit-session

@@ -22,7 +22,7 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help edit-session $@)" >&2
+  tmuxifier-help edit-session "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-edit-window

@@ -22,7 +22,7 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help edit-window $@)" >&2
+  tmuxifier-help edit-window "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-help

@@ -18,7 +18,7 @@ if calling-complete "$@"; then
 fi
 
 has-help() {
-  grep -i "^# Provide tmuxifier help" "$1" >/dev/null
+  grep -i "^# Provide tmuxifier help" "$1" > /dev/null
 }
 
 if [ -z "$1" ]; then

libexec/tmuxifier-init

@@ -14,25 +14,25 @@ if [ -z "$shell" ]; then
 fi
 
 case "$shell" in
-  bash )
+  bash)
     profile='~/.bash_profile'
     ;;
-  zsh )
+  zsh)
     profile='~/.zshrc'
     ;;
-  ksh )
+  ksh)
     profile='~/.profile'
     ;;
-  csh )
+  csh)
     profile='~/.cshrc'
     ;;
-  tcsh )
+  tcsh)
     profile='~/.tcshrc'
     ;;
-  fish )
+  fish)
     profile='~/.config/fish/config.fish'
     ;;
-  * )
+  *)
     profile='shell init file'
     ;;
 esac
@@ -45,15 +45,15 @@ Load Tmuxifier by adding the following to your ${profile}:
 "
 
   case "$shell" in
-    csh | tcsh )
+    csh | tcsh)
       echo "    eval \`tmuxifier init -\`
 "
       ;;
-    fish )
+    fish)
       echo "    eval (tmuxifier init -)
 "
       ;;
-    * )
+    *)
       echo "    eval \"\$(tmuxifier init -)\"
 "
       ;;
@@ -64,21 +64,26 @@ Load Tmuxifier by adding the following to your ${profile}:
 fi
 
 # Print help if "-" argument is not given
-if [[ " $@ " != *" - "* ]]; then
-  echo "$(tmuxifier-help init $@)" >&2
+if [[ " $* " != *" - "* ]]; then
+  tmuxifier-help init "$@" >&2
   exit 1
 fi
 
 case "$shell" in
-  csh | tcsh )
+  csh | tcsh)
     echo "setenv TMUXIFIER \"$TMUXIFIER\";"
     echo "source \"\$TMUXIFIER/init.tcsh\";"
     ;;
-  fish )
+  fish)
     echo "set -gx TMUXIFIER \"$TMUXIFIER\";"
-    echo "source \"\$TMUXIFIER/init.fish\";"
+    # fish shell 2.0.0 does not have the source alias
+    if [[ $(fish --version 2>&1 | awk -F'version ' '{print $2}') = '2.0.0' ]]; then
+      echo ". \"\$TMUXIFIER/init.fish\";"
+    else
+      echo "source \"\$TMUXIFIER/init.fish\";"
+    fi
     ;;
-  * )
+  *)
     echo "export TMUXIFIER=\"$TMUXIFIER\";"
     echo "source \"\$TMUXIFIER/init.sh\";"
     ;;

libexec/tmuxifier-list-sessions

@@ -15,7 +15,7 @@ List all session layouts."
   exit
 fi
 
-list=$(find -L "$TMUXIFIER_LAYOUT_PATH" -name "*.session.sh")
+list=$(find -L "$TMUXIFIER_LAYOUT_PATH" -name "*.session.sh" | sort)
 for file in $list; do
   file=${file/$TMUXIFIER_LAYOUT_PATH\//}
   echo "${file/.session.sh/}"

libexec/tmuxifier-list-windows

@@ -15,7 +15,7 @@ List all window layouts."
   exit
 fi
 
-list=$(find -L "$TMUXIFIER_LAYOUT_PATH" -name "*.window.sh")
+list=$(find -L "$TMUXIFIER_LAYOUT_PATH" -name "*.window.sh" | sort)
 for file in $list; do
   file=${file/$TMUXIFIER_LAYOUT_PATH\//}
   echo "${file/.window.sh/}"

libexec/tmuxifier-load-session

@@ -19,7 +19,7 @@ Arguments:
                                 directory, or path to a session layout file.
    <iterm mode>               - When given as \"-CC\" tmux will be called with
                                 the -CC argument enabling iTerm2 integration.
-                                More info: http://bit.ly/1yDbMlm"
+                                More info: https://iterm2.com"
   exit
 fi
 
@@ -30,7 +30,7 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help load-session $@)" >&2
+  tmuxifier-help load-session "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-load-window

@@ -26,14 +26,14 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help load-window $@)" >&2
+  tmuxifier-help load-window "$@" >&2
   exit 1
 fi
 
 # Load runtime functions.
 source "$TMUXIFIER/lib/runtime.sh"
 
-if [ ! -z $TMUX ]; then
+if [ ! -z "$TMUX" ]; then
   session="$(tmuxifier-current-session)"
   load_window "$1"
 else

libexec/tmuxifier-new-session

@@ -22,7 +22,7 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help new-session $@)" >&2
+  tmuxifier-help new-session "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-new-window

@@ -22,7 +22,7 @@ if calling-complete "$@"; then
 fi
 
 if [ -z "$1" ]; then
-  echo "$(tmuxifier-help new-window $@)" >&2
+  tmuxifier-help new-window "$@" >&2
   exit 1
 fi
 

libexec/tmuxifier-resolve-command-path

@@ -1,30 +1,6 @@
 #! /usr/bin/env bash
-set -e
 [ -n "$TMUXIFIER_DEBUG" ] && set -x
 
-# Load internal utility functions.
-source "$TMUXIFIER/lib/util.sh"
+source "$TMUXIFIER/lib/load.sh"
 
-# Provide tmuxifier help
-if calling-help "$@"; then
-  echo "usage: tmuxifier resolve-command-path <command_or_alias>
-
-Outputs the absolute path to the given command or command alias."
-  exit
-fi
-
-if [ -n "$1" ]; then
-  ! command_path="$(command -v "tmuxifier-$1")"
-  if [ -z "$command_path" ]; then
-    resolved="$(tmuxifier-alias "$1")"
-    if [ -n "$resolved" ]; then
-      ! command_path="$(command -v "tmuxifier-$resolved")"
-    fi
-  fi
-fi
-
-if [ -n "$command_path" ]; then
-  echo "$command_path"
-else
-  exit 1
-fi
+tmuxifier-resolve-command-path "$@"

libexec/tmuxifier-tmux-version

@@ -1,60 +1,6 @@
 #! /usr/bin/env bash
-shopt -s extglob
 [ -n "$TMUXIFIER_DEBUG" ] && set -x
 
-# Load internal utility functions.
-source "$TMUXIFIER/lib/util.sh"
+source "$TMUXIFIER/lib/load.sh"
 
-# Provide tmuxifier help
-if calling-help "$@"; then
-  echo "usage: tmuxifier tmux-version [<target-version>]
-
-Outputs current Tmux version. If given optional target-version it outputs one
-of three possible characters indicating if the current Tmux version number is
-equal to, less than, or greater than the [target-version].
-
-The three possible outputs are \"=\", \"<\", and \">\"."
-  exit
-fi
-
-# The vercomp() function is shamelessly ripped/borrowed from the following
-# StackOverflow answer: http://stackoverflow.com/a/4025065/42146
-vercomp () {
-  if [[ $1 == $2 ]]; then return 0; fi
-
-  local IFS=.
-  local i ver1=($1) ver2=($2)
-
-  # fill empty fields in ver1 with zeros
-  for ((i=${#ver1[@]}; i<${#ver2[@]}; i++)); do ver1[i]=0; done
-
-  for ((i=0; i<${#ver1[@]}; i++)); do
-    # fill empty fields in ver2 with zeros
-    if [[ -z ${ver2[i]} ]]; then ver2[i]=0; fi
-
-    if ((10#${ver1[i]} > 10#${ver2[i]})); then
-      return 1
-    elif ((10#${ver1[i]} < 10#${ver2[i]})); then
-      return 2
-    fi
-  done
-  return 0
-}
-
-version=$(tmux -V)
-version=${version/tmux /}
-
-if [ -n "$1" ]; then
-  # Fix for "1.9a" version comparison, as vercomp() can only deal with
-  # purely numeric version numbers.
-  version=${version//+([a-zA-Z])/}
-
-  vercomp "$version" "$1"
-  case $? in
-    0) echo '=';;
-    1) echo '>';;
-    2) echo '<';;
-  esac
-else
-  echo "$version"
-fi
+tmuxifier-tmux-version "$@"

libexec/tmuxifier-version

@@ -13,4 +13,4 @@ Outputs Tmuxifier version."
   exit
 fi
 
-echo "0.12.2"
+echo "0.13.0"

tmuxifier.tmux

@@ -0,0 +1 @@
+#!/usr/bin/env bash