Skip to content
A framework for setting up your vim configuration, with a ton of plugins, colorschemes and keymap bindings. Driven by the community, for the community!
Find file
Pull request Compare This branch is 15 commits behind kibs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Vim Kicks Ass

This is an attempt of creating some sort of framework for managing you VIM configuration, in a social way. A lot of people share their .vimrc on github, which is great, but chances that you find exactly the VIM configuration you like is pretty small. This project is (or will be) a collection of popular VIM plugins, colorschemes and custom made presets, which can be enabled or disabled easily using the included vim-kicks-ass plugin. You will also find templates which you can use as your own vimrc, or you can use them for inspiration for creating your own.

My inspiration comes from the great oh-my-zsh project, where a lot of people has forked, contributed and otherwise helped creating a great framework for configuring zshell. I wan't the same for VIM.

I am not the greatest vimscript developer, nor am I the most advanced superuser of VIM, but with help from the community, I hope this project can become a great help for all those VIM lovers out there.


haven't testet a lot, as this is an alpha release, but you should have

  • VIM 7.3
  • git in your path


3 small steps is required for getting up and running

# clone this repository
$ git clone ~/.vim-kicks-ass

# enable vim-kicks-ass
$ mkdir -p ~/.vim/autoload
$ ln -s ~/.vim-kicks-ass/vim_kicks_ass.vim ~/.vim/autoload/vim_kicks_ass.vim

# create a .vimrc file, and use functions described further down, or choose a template as a starting point
$ cp ~/.vim-kicks-ass/templates/vimrc ~/.vimrc

And you should be good to go. The first time you start vim, it can take some time depending on how many plugins you enabled


just goto your vim-kicks-ass folder and update using git

$ cd ~/.vim-kicks-ass
$ git pull
$ git submodule update



Use this for enabling all the plugins you want, can be called as many times you want. Can take a single string, or a list of plugins

call vim_kicks_ass#with_plugins("fugitive")
call vim_kicks_ass#with_plugins(["markdown", "surround"])


if you want to remove a plugin, after you already added it, you can use this

call vim_kicks_ass#without_plugins("fugitive")
call vim_kicks_ass#without_plugins(["markdown", "surround"])


load all the colorschemes you want, and don't forget to actually set it

call vim_kicks_ass#using_colorschemes("jellybeans")
colorscheme jellybeans


presets are just small blocks of configuration, if you like a specific preset you can enable it, and save yourself some configuration

call vim_kicks_ass#using_presets("ruby")


Please fork and send pull requests, together we can make this big ;)


I have copied some functions from the great pathogen project by Tim Pope, his vim plugins are the best!

Something went wrong with that request. Please try again.