prezto/plugins/tmux/README.md

tmux Plugin
===========

Plugin enhancing the [tmux](http://tmux.sourceforge.net/) multiplexer.

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 a Zsh session is opened.

To enable this feature, one line has to be added to the configuration file:

    zstyle ':omz:plugin:tmux' auto-start 'yes'

This will automatically create a background session named "#OMZ" and attach every new shell to it.

To avoid keeping open sessions, this plugin sets ``destroy-unattached off`` on the background session and ``destroy-unattached on`` on every other session (global setting).

Caveats
-------

For some reasons, tmux seems to cause kernel panics on Mac OS X.  
A discussion about this and OMZ has already been opened [here](http://git.io/jkPqHg).

Authors
-------

*The authors of this plugin should be contacted via the github bug tracker.*

 - [Sorin Ionescu](/sorin-ionescu)
 - [Colin Hebert](/ColinHebert)
Add documentation for tmux 2012-03-29 20:31:55 +00:00			`tmux Plugin`
			`===========`

			`Plugin enhancing the [tmux](http://tmux.sourceforge.net/) multiplexer.`

			`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 a Zsh session is opened.`

			`To enable this feature, one line has to be added to the configuration file:`

[#78] Fix tmux and screen auto-start documentation 2012-03-30 16:22:02 +00:00			`zstyle ':omz:plugin:tmux' auto-start 'yes'`
Add documentation for tmux 2012-03-29 20:31:55 +00:00
			`This will automatically create a background session named "#OMZ" and attach every new shell to it.`

			To avoid keeping open sessions, this plugin sets ``destroy-unattached off`` on the background session and ``destroy-unattached on`` on every other session (global setting).

			`Caveats`
			`-------`

			`For some reasons, tmux seems to cause kernel panics on Mac OS X.`
			`A discussion about this and OMZ has already been opened [here](http://git.io/jkPqHg).`

			`Authors`
			`-------`

			`The authors of this plugin should be contacted via the github bug tracker.`

			`- [Sorin Ionescu](/sorin-ionescu)`
			`- [Colin Hebert](/ColinHebert)`