vim plugin to interact with tmux
Switch branches/tags
Clone or download
Pull request Compare This branch is 35 commits ahead, 115 commits behind benmills:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Fix typo in section 2.4 Jul 29, 2012
plugin Changes all echo commands to do a redraw first Aug 14, 2012
.gitignore Initial rev plus my scroll up and down commands Jul 17, 2012
README.mkd Removes the requirement of ruby in the README Aug 11, 2012



Easily interact with tmux from vim.


What inspired me to write vimux was tslime.vim, a plugin that lets you send input to tmux. While tslime.vim works well, I felt it wasn't optimized for my primary use case which was having a smaller tmux pane that I would use to run tests or play with a REPL.

My goal with vimux is to make interacting with tmux from vim effortless. By default when you call RunVimTmuxCommand vimux will create a 20% tall horizontal pane under your current tmux pane and execute a command in it without losing focus of vim. Once that pane exists whenever you call RunVimTmuxCommand again the command will be executed in that pane. As I was using vimux myself I wanted to rerun commands over and over. An example of this was running the current file through rspec. Rather than typing that over and over I wrote RunLastVimTmuxCommand that will execute the last command you called with RunVimTmuxCommand.

Other auxiliary functions and the ones I talked about above can be found bellow with a full description and example key binds for your vimrc.


With vim-bundle: vim-bundle install benmills/vimux

Otherwise download the latest tarball, extract it and move plugin/vimux.vim inside ~/.vim/plugin. If you're using pathogen, then move the entire folder extracted from the tarball into ~/.vim/bundle.

Platform-specific Plugins


The full documentation is available online and accessible inside vim :help vimux