Skip to content
Ctags-like tag generator for CoffeeScript
Ruby CoffeeScript VimL JavaScript Shell
Failed to load latest commit information.
bin Changed passing of options to an object to reduce complexity in addin…
lib 0.5.1 -> 0.6.0
plugin Fix TagBar
script Improve bump script
spec 0.5.1 -> 0.6.0
.coveralls.yml Initial coveralls setup
.gitignore Initial coveralls setup
.rspec .rspec file
.rvmrc add the .rvmrc content back
.travis.yml Add ruby 2.2 to travis test matrix
CoffeeTags.gemspec Bump to 0.5.1
Gemfile Bump to 0.5.1
Guardfile closes #1 and #2 Fix Asciinema link and remove broken screenshot. Fixes #54
Rakefile fix failling specs and improve the Rakefile so that it works with Tra…


Latest version: Gem version

A simple tool for generating CoffeeScript tags (Ctags compatible).

Build Status Coverage Status

Watch a quick demo


CoffeeTags was created for use with Vim and TagBar plugin, however it accepts most common ctags arguments, therefore the following:

coffeetags -R -f TAGS

will generate standard TAGS file which later can be used with Vim (standard :tag command works as expected)


  • ruby 1.8.7 and up

Windows support

Yup, we got it!

Editors supported


Just use coffeetags --help

Ruby Gem


gem install CoffeeTags (or sudo gem install CoffeeTags)


$ coffeetags --help


This can also be used as a vim plugin that will update tag files on save, and support visualization with TagBar. You will still need to install the gem as described above as well as install the plugin to vim. You can install it via:


  • Pathogen
    • git clone ~/.vim/bundle/CoffeeTags
  • NeoBundle
    • NeoBundle 'lukaszkorecki/CoffeeTags'
  • Vundle
    • Bundle 'lukaszkorecki/CoffeeTags'
  • manual
    • copy all of the files into your ~/.vim directory


In you ~/.vimrc you can configure the plugin with:

let g:CoffeeAutoTagDisabled=<0 or 1>     " Disables autotaging on save (Default: 0 [false])
let g:CoffeeAutoTagFile=<filename>       " Name of the generated tag file (Default: ./tags)
let g:CoffeeAutoTagIncludeVars=<0 or 1>  " Includes variables (Default: 0 [false])
let g:CoffeeAutoTagTagRelative=<0 or 1>  " Sets file names to the relative path from the tag file location to the tag file location (Default: 1 [true])

Sublime Text

See this issue on SublimeText/Ctags

Config types

CoffeeTags can work in 2 modes:

  • tags only for functions (default)
  • tags for functions and objects containing them

Second mode is activated by:

  • Adding --include-vars to command line arguments
  • Setting let g:CoffeeAutoTagIncludeVars=1 in your ~/.vimrc for vim


  • squash all bugs



Bitdeli Badge

Something went wrong with that request. Please try again.