codeclimate-test-reporter - [DEPRECATED]

These configuration instructions refer to a language-specific test reporter who is now deprecated in favor of our new unified test reporter client. The new test reporter is faster, distributed as a static binary, has support for parallelized CI builds, and will receive ongoing support by the team here. The existing test reporters for Ruby, Python, PHP, and Javascript are now deprecated.

Code Climate

Posts SimpleCov test coverage data from your Ruby test suite to Code Climate's hosted, automated code review service.

Code Climate -


This gem requires a user, but not necessarily a paid account, on Code Climate, so if you don't have one the first step is to signup at: Then follow the instructions on our documentation site.

Please contact [email protected] if you need any assistance setting this up.


bundle exec rspec && CODECLIMATE_REPO_TOKEN=my_token bundle exec codeclimate-test-reporter

Optional: configure CODECLIMATE_API_HOST to point to a self-hosted version of Code Climate.

Troubleshooting / FYIs

Across the many different testing frameworks, setups, and environments, there are lots of variables at play. If you're having any trouble with your test coverage reporting or the results are confusing, please see our full documentation here:

Upgrading from pre-1.0 Versions

Version 1.0 of this gem introduced new, breaking changes to the way the test reporter is meant to be executed. The following list summarizes the major differences:

See the changelog entry for v1.0.0 for details.


Patches, bug fixes, feature requests, and pull requests are welcome on the GitHub page for this project:

When making a pull request, please update the changelog.

This gem is maintained by Code Climate ([email protected]).

Release Process

  • Update the changelog to mark the unreleased changes as part of the new release.
  • Update the version.rb with the new version number
  • Make a pull request with those changes
  • Merge those changes to master
  • Check out and pull down the latest master locally
  • rake release which will
    • tag the latest commit based on version.rb
    • push to github
    • push to rubygems


Portions of the implementation were inspired by the coveralls-ruby gem.