Headlights: Know thy Bundles
Python Vim script
Latest commit 2e80772 Sep 15, 2012 @mbadran ignoring rope (again)
Failed to load latest commit information.
plugin change the special buffer marker Sep 15, 2012
.gitignore ignoring rope (again) Sep 15, 2012
README.mkd document two new options Sep 2, 2012
headlights_ss.png new screenshot Jul 14, 2011


Headlights in Action

Headlights adds a Bundles [^1] menu to Vim, revealing your bundles (aka. plugins) and the features they provide.

Headlights creates a menu for each currently loaded [^2] bundle, grouping together docs, commands, mappings, abbreviations, functions, highlights, and plugin files.

Combined with a powerful bundle manager, Headlights will improve your Vim user experience quality of life.

Get Headlights

NOTE: Headlights requires Vim 7+ compiled with Python 2.6+ support.

The Recommended Way

Using Vundle:

  1. Add the following line to the Vundle section in your .vimrc:

    Bundle 'mbadran/headlights'

  2. Run the following Vim command:


The Manual Way

  1. Download the latest package.

  2. Expand the archive's contents into your vim directory.

  3. Run the following Vim command:

    helptags <vim_dir>/<plugin_dir>/<headlights_dir>/doc/

Explore the Options

let g:headlights_use_plugin_menu = 0 (Disabled)

let g:headlights_smart_menus = 1 (Enabled)

let g:headlights_show_commands = 1 (Enabled)

let g:headlights_show_mappings = 1 (Enabled)

let g:headlights_show_abbreviations = 0 (Disabled)

let g:headlights_show_functions = 0 (Disabled)

let g:headlights_show_highlights = 0 (Disabled)

let g:headlights_show_files = 0 (Disabled)

let g:headlights_show_load_order = 0 (Disabled)

let g:headlights_debug_mode = 0 (Disabled)

let g:headlights_run_on_startup = 0 (Disabled)

let g:headlights_spillover_menus = 0 (Disabled)

Go Deeper

Refer to the Headlights help document:

Bundles > a - i > headlights > Help

:help headlights


If you use MacVim, you can quickly access any plugin by typing its name. For example, hit CMD-? to bring up a search dialog for menu items, then type fug open to reveal the fugitive.vim file as the first result. You can also type fug help to quickly access the documentation. I do this, like, all the time.

[^1]: Headlights is inspired by TextMate's Bundles menu.

[^2]: Headlights mirrors Vim's scriptnames command, revealing only the bundles that are currently loaded. This is fast because it avoids file system access, but the trade off is that autoload and ftplugin scripts are not revealed until they are needed. (This is Good Enough ™.)