CCH - Check on changes for ruby projects

cch will list all files that has been changed so far and run what you need with them (tests, code lints, etc).

In order words, it will use git to see the changes and then run a command like rspec with this files.

gem status

Build Status Gem Version Code Climate Test Coverage Dependency Status Yard Docs


gem install cch



Or on run time, you can specify the runners:

cch rspec rubocop


After running cch for the first time, the script will create a config file for you: cchfile.rb.

Configure through the cchfile.rb what you want to run by cch: [:rubocop, :haml_lint, :rspec, :cucumber]

Cch comes with some basic configuration for:

  • rspec
  • rubocop
  • haml_lint
  • cucumber

You can create your own configuration in your cchfile.rb. Use the following configuration files as the base for it:


  1. checking out the repo
  2. run bin/setup to install dependencies
  3. run bundle exec rake to run the all necessary checks like documentation, code style and tests

You can also run bin/console for an interactive prompt that will allow you to experiment.

Install locally

bundle exec rake install
gem install --local pkg/cch*.gem

Release a new version

Change version.rb file, commit, push and then:

bundle exec rake release
git push origin master
git push origin --tags

This will deploy a new release on


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The gem is available as open source under the terms of the MIT License.