An exception handler for OpsCode Chef runs, GitHub Gist & IRC.
Latest commit 7158879 Jul 9, 2012 @portertech Merge branch 'readme'
Failed to load latest commit information.
lib [redundant] remove redundant chef log output w/ tty Jun 28, 2012
LICENSE [readme] replaced readme, org -> md, replaced license Jul 8, 2012 [readme] improved description Jul 8, 2012

Chef IRC Snitch

Chef IRC Snitch is an OpsCode Chef exception handler for notifying people when a Chef run fails via IRC; providing a link to a private GitHub Gist containing node information, an exception message, and a backtrace. The IRC message also includes the node name and its run list, making it possible to sift/search through logs for a specific failure. Using GitHub Gists to store failure information provides a convenient way to share with others.


gem install chef-irc-snitch


Append the following to your Chef client configs, usually at /etc/chef/client.rb

# Notify admins via IRC when a Chef run fails
require "chef-irc-snitch"

irc_uri = "irc://"
enable_ssl = true

irc_handler =, enable_ssl)

exception_handlers << irc_handler

Alternatively, you can use the LWRP (available @


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request