knife plugin to display role hierarchies
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A plugin for Chef::Knife which displays the roles that are included recursively within a role and optionally displays all the roles that include it.


Supply a role name to get a dump of its hierarchy, pass -i for the roles that also include it

% knife crawl VMDevStack -i                                                                                                                         ✹

VMDevStack child hierarchy:
 * VMDevStack
   * SharedDevStack

VMDevStack is included in the following roles:
   * VMBase


Script install

Copy the knife-crawl script from lib/chef/knife/crawl.rb to your ~/.chef/plugins/knife directory.

Gem install

knife-crawl is available on - if you have that source in your gemrc, you can simply use:

gem install knife-crawl