Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



22 Commits

Repository files navigation


A simple way to execute Vim buffer contents with a shell command and view the results in a split window.

I find this most useful for SQL queries however, this will work with any program that can be called from the shell.

The Plugin In Action


How It Works

The plugin provides two commands:


These commands allow you to execute either the entire buffer or the visually selected region. The first line passed to the plugin is the shell command that will be used to run the remaing lines of code. For example, to run a mysql query, the first line connects to the database and the remaining lines are the query being executed.

The example shown in the .gif above:

mysql -t -u root example
select * from mysql_example_table;


Use your plugin manager of choice.

  • Pathogen
    • git clone ~/.vim/bundle/vim-shell-executor
  • Vundle
    • Add Plugin '' to .vimrc
    • Run :PluginInstall
  • NeoBundle
    • Add NeoBundle '' to .vimrc
    • Run :NeoBundleInstall
  • vim-plug
    • Add Plug '' to .vimrc
    • Run :PlugInstall