Tmuxinator

Create and manage tmux sessions easily.

Example

Installation

$ gem install tmuxinator

Editor and Shell

tmuxinator uses your shell's default editor for opening files. If you're not sure what that is type:

$ echo $EDITOR

For me that produces "mate -w" If you want to change your default editor simple put a line in ~/.bashrc that changes it. Mine looks like this:

export EDITOR='mate -w'

Environment Integration

Add this to your ~/.bashrc (or similar)

[[ -s $HOME/.tmuxinator/scripts/tmuxinator ]] && source $HOME/.tmuxinator/scripts/tmuxinator

If tabs (windows) names are not displayed properly add also export DISABLE_AUTO_TITLE=true there.

For command line completion you can source the tmuxinator_completion file, which is in the same directory as tmuxinator binary file. That will auto-complete tmuxinator commands, plus your .yml config files.

Usage

Create a project

$ tmuxinator new project_name

Create or edit your projects with this command, for editing you can also use tmuxinator open project_name. new aliased to o,open and n. Your default editor ($EDITOR) is used to open the file. If this is a new project you will see this default config:

# ~/.tmuxinator/project_name.yml
# you can make as many tabs as you wish...

project_name: Tmuxinator
project_root: ~/code/rails_project
socket_name: foo # Not needed. Remove to use default socket
rvm: 1.9.2@rails_project
pre: sudo /etc/rc.d/mysqld start
tabs:
  - editor:
      layout: main-vertical
      panes:
        - vim
        - #empty, will just run plain bash
        - top
  - shell: git pull
  - database: rails db
  - server: rails s
  - logs: tail -f logs/development.log
  - console: rails c
  - capistrano:
  - server: ssh me@myhost

If a tab contains multiple commands, they will be joined together with &&. If you want to have your own default config, place it into $HOME/.tmuxinator/default.yml

The pre command allows you to run anything before starting the tmux session. Could be handy to make sure you database daemons are running. Multiple commands can be specified, just like for tabs.

Panes Support

You can define your own panes inside a window likes this:

- window_with_panes
    layout: main-vertical
    panes:
      - vim
      - #empty, will just run plain bash
      - top

The layout setting gets handed down to tmux directly, so you can choose from one of the five standard layouts or specify your own.

Starting a project

$ start_[project_name]

Shorthand

You can also use this shorthand alias for tmuxinator

$ mux [command/project_name]

This will fire up tmux with all the tabs you configured.

Other Commands

$ tmuxinator copy existing_project new_project

Copy an existing project. aliased to c and cp

$ tmuxinator list

List all the projects you have configured. aliased to l

$ tmuxinator delete project_name

Remove a project. aliased to rm

$ tmuxinator implode

Remove all tmuxinator configs, aliases and scripts. aliased to i

$ tmuxinator doctor

Examines your environment and identifies problems with your configuration

$ tmuxinator version

shows tmuxinator's version. aliased to v

$ tmuxinator help

shows tmuxinator's help. aliased to h

Questions? Comments? Feature Request?

I would love to hear your feedback on this project! head over to issues section and make a ticket.

Contributors

See the full list of contributors

History

v. 0.6.0

Removed base-index option when starting up the tmux server, so that users can use their base-index settings in tmux.conf (sevenpg)

v. 0.5.0

Added optional socket name support (Thanks to Adam Walters)
Added auto completion (Thanks to Jose Pablo Barrantes)

####v. 0.4.0

Does not crash if given an invalid yaml file format. report it and exit gracefully.
Removed clunky scripts & shell aliases (Thanks to Dane O'Connor)
Config files are now rendered JIT (Thanks to Dane O'Connor)
Can now start sessions from cli (Thanks to Dane O'Connor)

####v. 0.3.0

Added pre command (Thanks to Ian Yang)
Added multiple pre command (Thanks to Bjørn Arild Mæland)
Using tmux set default-path for project root
New aliases

####v. 0.2.0

added pane support (Thanks to Aaron Spiegel)
RVM support (Thanks to Jay Adkisoon)

Inspiration and Thanks

Inspired by Jon Druse's (Screeninator) and Arthur Chiu's (Terminitor)

Contributing to tmuxinator

Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
Fork the project
Start a feature/bugfix branch
Commit and push until you are happy with your contribution
Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

slawosz/tmuxinator