Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Automatic ctags generation on gem install
Tag: v1.0.2

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


RubyGems Automatic Ctags Invoker

Nary a day of Ruby development goes by where I don't run bundle open or gem open. And when I go rooting around in a gem, I want tags. As good as I've gotten at ctags -R ., I've grown weary of it. So I wrote a RubyGems plugin to automatically invoke Ctags on gems as they are installed.


If you haven't already, install Exuberant Ctags and make sure it comes first in $PATH. With Homebrew, brew install ctags. Now all that's left to do is install gem-ctags and perform a one-off indexing of the gems that are already installed:

gem install gem-ctags
gem ctags

If you're using RVM, I recommend extending your global gemset by adding gem-ctags to ~/.rvm/gemsets/global.gems. Put it at the top so the gems below it will be indexed.

Vim Tips

If you have rake.vim installed (which, by the way, is a misleading name), Vim will already know where to look for the tags file when editing a gem.

If you have bundler.vim installed, Vim will be aware of all tags files from all gems in your bundle.

If you want to get crazy, add this to your vimrc to get Vim to search all gems in your current RVM gemset (requires pathogen.vim):

autocmd FileType ruby let &l:tags = pathogen#legacyjoin(pathogen#uniq(
      \ pathogen#split(&tags) +
      \ map(split($GEM_PATH,':'),'v:val."/gems/*/tags"')))

I don't like to get crazy.


Don't submit a pull request with an ugly commit message or I will ignore your patch until I have the energy to politely explain my zero tolerance policy.


Copyright (c) Tim Pope. MIT License.

Something went wrong with that request. Please try again.