rhubarb.vim

If fugitive.vim is the Git, rhubarb.vim is the Hub. Or at least it could be. One day. Right now it's pretty stupid. I almost named it chubby.vim, but it just didn't feel right.

So far there's only one feature: In Git commit messages, GitHub issues and collaborators can be omni-completed (<C-X><C-O>, see :help compl-omni). This makes inserting those Closes #123 remarks slightly easier than copying and pasting from the browser.

Maybe I'll extract :Gbrowse out of fugitive.vim and put it here instead. Or maybe I'll add some cool Gist stuff. You never know with rhubarb.vim.

Installation

If you don't have a preferred installation method, I recommend installing pathogen.vim, and then simply copy and paste:

cd ~/.vim/bundle
git clone git://github.com/tpope/vim-rhubarb.git
vim -u NONE -c "helptags vim-rhubarb/doc" -c q

In addition to fugitive.vim, Curl is required (included with OS X). There are 5 ways you can tell rhubarb.vim your GitHub credentials:

1. In a netrc:

    echo 'machine api.github.com login <user> password <password>'>>~/.netrc
   

2. In Git:

    git config --global github.user <user>
    git config --global github.password <password>
   

3. In your shell:

    export GITHUB_USER=<user>
    export GITHUB_PASSWORD=<password>
   

4. In Vim:

    let g:github_user = '<user>'
    let g:github_password = '<password>'
   

5. With an API token:

    let g:RHUBARB_TOKEN = '<token>'
   

FAQ

How do I turn off that preview window that shows the issue body?

set completeopt-=preview

Self-Promotion

Like rhubarb.vim? Follow the repository on GitHub. And if you're feeling especially charitable, follow tpope on Twitter and GitHub.

License

Copyright (c) Tim Pope. Distributed under the same terms as Vim itself. See :help license.