Vundle, the plug-in manager for Vim
Vim script
Switch branches/tags
Clone or download
Pull request Compare This branch is 1 commit ahead, 336 commits behind VundleVim:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Vundle is short for Vimbundle and is a Vim plugin manager.

Quick start

  1. Setup Vundle:

    $ git clone ~/.vim/bundle/vundle
  2. Configure bundles:

    Sample .vimrc:

    set nocompatible               " be iMproved
    filetype on                    " required on OS X!
    filetype off                   " required!
    set rtp+=~/.vim/bundle/vundle/
    call vundle#rc()
    " let Vundle manage Vundle
    Bundle 'gmarik/vundle'         " required! 
    " My Bundles here:
    " original repos on github
    Bundle 'tpope/vim-fugitive'
    Bundle 'lokaltog/vim-easymotion'
    Bundle 'rstacruz/sparkup', {'rtp': 'vim/'}
    " vim-scripts repos
    Bundle 'L9'
    Bundle 'FuzzyFinder'
    Bundle 'rails.vim'
    " non github repos
    Bundle 'git://'
    " ...
    filetype plugin indent on     " required! 
    " or 
    " filetype plugin on          " to not use the indentation settings set by plugins
    " Brief help
    " :BundleInstall  - install bundles (won't update installed)
    " :BundleInstall! - update if installed
    " :Bundles foo    - search for foo
    " :Bundles! foo   - refresh cached list and search for foo
    " :BundleClean    - confirm removal of unused bundles
    " :BundleClean!   - remove without confirmation
    " see :h vundle for more details
  3. Install configured bundles:

    Launch vim, run :BundleInstall.

    Windows users see Vundle for Windows

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

Why Vundle

Vundle allows to:

Also Vundle:

  • manages runtime path of your installed scripts
  • regenerates helptag atomatically


see :h vundle vimdoc for more details.


See gmarik's vimrc for working example.

If you have an interesting example, feel free to send a pull request with link to your config. Thx!


  • Q Why am I asked for username/pass?

    A This is the case of invalid name used with Bundle, which leads to attempt to clone nonexistent repo:

    git clone
    Cloning into non_existin_repo...
    fatal: Authentication failed
  • Q My configuration is bundle dependant, so when I try to install plugins for the first time I get errors. How do I fix that?

    A Fix your Chicken or Egg dilemma


Thank you!

Inspiration and ideas from


  • Vundle was developed and tested with Vim 7.3 on OSX, Linux and Windows
  • Vundle tries to be as KISS as possible


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

  • √ activate newly added bundles on .vimrc reload or after :BundleInstall
  • √ use preview window for search results
  • √ vim documentation
  • √ put vundle to bundles/ too(will fix vundle help)
  • √ tests
  • improve error handling
  • handle dependencies
  • allow specify revision/version?
  • search by description as well
  • show description in search results
  • instead sourcing .vimrc before installation come up with another solution
  • make it rock!