About

Vundle is a short cut for Vimbundle and is a small plugin for managing Vim plugins.

Why

Vundle allows to:

• keep track and configure your scripts right in .vimrc
• install configured scripts (aka bundle)
• manage runtime path of your installed scripts so you don't have to
• search all available vim scripts by name
• disable/enable bundles by commenting/uncommenting configured Bundle(requires reload)

Vundle takes advantage of vim-scripts.org in order to install/search all available vim scripts

How

1. Setup Vundle:

    git clone http://github.com/gmarik/vundle.git ~/.vim/vundle.git
   

2. Configure bundles:

   Append to your ~/.vimrc:

    set rtp+=~/.vim/vundle.git/ 
    call vundle#rc()
   
    " My bundles
    Bundle "L9"
    Bundle "FuzzyFinder"
    Bundle "rails.vim"
    Bundle "ack.vim"
    Bundle "git://git.wincent.com/command-t.git"
   

3. Install configured bundles:

   Launch vim, run :BundleInstall and restart Vim.

   Installing requires Git and triggers Git clone for each configured repo to ~/.vim/bundle/.

Searching

:BundleSearch foo

will split new window with results:

Bundle "VimFootnotes"
Bundle "foo.vim"

so you can just copy ones you need to .vimrc.

:BundleSearch! foo

will refresh scripts list before doing search.

Searching requires curl

Examples

See gmarik's vimrc for working example.

Inspiration and ideas from

• pathogen
• bundler
• Scott Bronson

TODO:

Vundle is a work in progress so any ideas/patches appreciated

• activate newly added bundles on .vimrc reload or after :BundleInstall
• improve error handling
• allow specify revision/version?
• search by description aswell
• show descrption in search results
• use location list/quick fix list for search results
• documentation
• tests
• make it rock!