[#23] Rename plugins to modules

modules/tmux/README.md

@@ -0,0 +1,46 @@
+tmux
+====
+
+Defines [tmux][1] aliases and provides for auto launching it at start-up.
+
+Aliases
+-------
+
+ - `ta` attach or switch to a tmux session.
+ - `tl` list sessions managed by the tmux server.
+
+Settings
+--------
+
+### Auto-start
+
+Start a tmux session automatically when Zsh is launched.
+
+To enable this feature, add the following line to *zshrc*:
+
+    zstyle ':omz:module:tmux' auto-start 'yes'
+
+It will create a background session named _#OMZ_ and attach every new shell to
+it.
+
+To avoid keeping open sessions, this module sets `destroy-unattached off` on
+the background session and `destroy-unattached on` on every other session
+(global setting).
+
+Caveats
+-------
+
+tmux is known to cause kernel panics on Mac OS X. A discussion about this and
+OMZ has already been opened [here][2].
+
+Authors
+-------
+
+*The authors of this module should be contacted via the github bug tracker.*
+
+ - [Sorin Ionescu](/sorin-ionescu)
+ - [Colin Hebert](/ColinHebert)
+
+[1]: http://tmux.sourceforge.net
+[2]: http://git.io/jkPqHg
+

modules/tmux/init.zsh

@@ -0,0 +1,34 @@
+#
+# Defines tmux aliases and provides for auto launching it at start-up.
+#
+# Authors:
+#   Sorin Ionescu <sorin.ionescu@gmail.com>
+#   Colin Hebert <hebert.colin@gmail.com>
+#
+
+# Aliases
+alias ta="tmux attach-session"
+alias tl="tmux list-sessions"
+
+# Auto Start
+if [[ -z "$TMUX" ]] && zstyle -t ':omz:module:tmux' auto-start; then
+  tmux_session='#OMZ'
+
+  if ! tmux has-session -t "$tmux_session" 2> /dev/null; then
+    # Disable the destruction of unattached sessions globally.
+    tmux set-option -g destroy-unattached off &> /dev/null
+
+    # Create a new session.
+    tmux new-session -d -s "$tmux_session"
+
+    # Disable the destruction of the new, unattached session.
+    tmux set-option -t "$tmux_session" destroy-unattached off &> /dev/null
+
+    # Enable the destruction of unattached sessions globally to prevent
+    # an abundance of open, detached sessions.
+    tmux set-option -g destroy-unattached on &> /dev/null
+  fi
+
+  exec tmux new-session -t "$tmux_session"
+fi
+