Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: c5216bb345
Fetching contributors…

Cannot retrieve contributors at this time

35 lines (20 sloc) 2.631 kb


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.


  • Vimux requires vim with compiled ruby support. You can confirm you have ruby support by running vim --version | grep +ruby.
  • Vimux assumes a tmux version >= 1.5. Some older versions might work but it is recommeded to use at least version 1.5.

Platform-specific Plugins

  • vim-vroom runner for rspec, cucumber and test/unit; vimux support via g:vroom_use_vimux
  • vimux-ruby-test a set of commands to easily run ruby tests
  • vimux-cucumber run Cucumber Features through Vimux
  • vim-turbux Turbo Ruby testing with tmux
  • vimux-pyutils A set of functions for vimux that allow to run code blocks in ipython


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

Jump to Line
Something went wrong with that request. Please try again.