Manage caveatPatchor.js files for Propane
JavaScript Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


CaveatPatchKids is a tool for generating caveatPatchor.js files and for easily sharing snippets for use in Propane.


Install in the usual way:

$ gem install caveat_patch_kids


To start, plant a caveat patch:

$ caveat-patch-kids plant
      create  /Users/yourface/.caveat_patch_kids/caveatPatchor.js

This creates a basic caveatPatchor.js you can customize using Sprockets directories. Either drop you code at the bottom, or require scripts provided by CaveatPatchKids.

When you are happy with the code, bloom it:

$ caveat-patch-kids bloom
       bloom  /Users/yourface/Library/Application Support/Propane/unsupported/caveatPatchor.js 

Now you can quit Propane, and launch it again. Hopefully nothing breaks...

If something does break, and you really need to get back into Propane, you can till:

$ caveat-patch-kids till
      remove  /Users/technicalpickles/Library/Application Support/Propane/unsupported/caveatPatchor.js


These scripts are provided by CaveatPatchKids. Include them by updating ~/.caveat_patch_kids/caveatPatchor.js like:

//= require caveat_patch_kids/the_script
  • caveat_patch_kids/display_avatars: display a Gravatar next to a user's name
  • caveat_patch_kids/display_cloudapp_images: display CloudApp images inline
  • caveat_patch_kids/display_librato: adjust librato graph links to embed a live version of the graph
  • caveat_patch_kids/display_scout: display Scout graph links as embeded graphs
  • caveat_patch_kids/embiggen_message_history: increase message history
  • caveat_patch_kids/stylize_diffs: colorize diffs with red/green
  • caveat_patch_kids/stylize_nagios: colorize nagios alerts
  • caveat_patch_kids/link_to_rdio_app: update Rdio links to go to the Rdio app, instead of a browser

The original caveatPatchor.js had a lot of mysterious and odd things. Those weren't included by default, but could be of use to someone, somewhere, or maybe just need some cleanup and documentation. See scripts/caveat_patch_kids/unsupported for the good.


For convience, a full bundles with several scripts are included. Require them like any other script:

  • caveat_patch_kids/bundles/all: all scripts, except ones that aren't unspoorted or require specific things on your system (ie rdio)
  • caveat_patch_kids/bundles/unsupported: all scripts, even ones unsupported. you probably shouldn't do this unless you are a crazy person



  • make it easy for other people to release their own scripts as gems, and be able to load them
  • include screenshots of scripts in action
  • review unsupported stuff more closely


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