Skip to content
Multiple source file management for Vim
Latest commit 03ea768 Aug 29, 2014 @joonty Merge pull request #4 from UmkaDK/minor-fixes
Minor fixes
Failed to load latest commit information.
autoload Fixed an empty line at the top of the new sauce Aug 28, 2014
skel Initial commit Mar 28, 2012
LICENSE add comment on another line Feb 5, 2014
VERSION Update to version 0.3.0 Jun 26, 2013

Sauce for Vim

Sauce is a manager for multiple vimrc files, which can be used to load different settings for different environments. In short, you can maintain lots of different vim settings files and only load the one(s) you need when you need them.

This can be used as a simple project organiser tool. For instance:

" Load the MyProject sauce
:Sauce MyProject

This "sauce" (read: source) can contain anything that you would put in your vimrc, and can be used to override those settings. In this case, it could be used to CD into the project directory, set spaces instead of tabs, open NERDTree, set configuration options for PHPQA tools, etc.

There's even autocomplete on the sauce names, so you don't need to remember them :)

Quick Guide

Actually, a quick guide is all that's needed. There are just a few handy functions to manage your sauces:

" Load a sauce
:Sauce <name>
" Create a new sauce
:SauceNew <name>
" Edit an existing sauce
:SauceEdit <name>
" Copy an existing sauce as a new sauce
:SauceCopy <name> (will ask for another name)
" Delete an existing sauce (will prompt you to confirm)
:SauceDelete <name>
" Rename an existing sauce (will ask for the new name)
:SauceRename <name>



Installation is easy-peasy if you're using Vundle. Just add this to your .vimrc file:

Bundle 'joonty/vim-sauce.git'

and run vim +BundleInstall +qall from a terminal.


cd ~/.vim/bundle
git clone git://

If you aren't using vundle, you will have to extract the files in each folder to the correct folder in .vim/.


No configuration is necessary, although it's possible to change the default directory where sauces are stored (~/.vimsauce). To do this, add this to your vimrc file:

let g:sauce_path = "/path/to/sauces"

Known Issues

The autocomplete currently won't work with Windows. However, plans are in place to change that.


Sauce for Vim is released under the MIT license. See the LICENSE file for more information.

Something went wrong with that request. Please try again.