A leaderboard for your Github organisation
Switch branches/tags
Nothing to show
Clone or download
Latest commit d44b672 Feb 8, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Adds timing report to the engine Feb 10, 2014
lib Allows self-merges Feb 9, 2016
.gitignore Bumps version, locks gemfile Feb 14, 2014
.ruby-version update ruby version to 2.1.2 Sep 1, 2014
Gemfile Fixes Gemfile Feb 9, 2016
Gemfile.lock Fixes caching Feb 9, 2016
LICENSE.txt Initial revision Nov 4, 2013
README.md Updates README Feb 14, 2014
Rakefile Fixes file naming Nov 10, 2013
githeroes.gemspec Fixes caching Feb 9, 2016


Git Heroes

Ever wanted to know your your team's top contributors are?

git heroes will tell you, based on their Github activity (pull requests, comments, and merges).

Caveat Emptor: no hard metric that measures individuals is reliable. Please do not use this to estimate someone's productivity. In combination with other tools, it can be effectivee to detect trends, though.


$ gem install git-heroes

To preserve your Github API usage limit, the tool requires locally running Redis instance for caching.


$ git heroes -r <your-organization> -t <github-token>

Outputs two files, report-timing.csv (time taken to merge pull requests) and report-points.csv (contribution points per user).

You'll probably want to pivot this in a spreadsheet application to get meaningful results; if you want a template for that just email me.


Usage: bin/git-heroes [options]
    -r, --organization ORG   Progress organization ORG (required)
    -o, --output FILE        Save report to FILE
    -t, --token TOKEN        A Github authentication token (defaults to GITHUB_TOKEN)
    -w, --weeks WEEKS        Report on the last WEEKS weeks (default 12).
    -v, --verbose            Run verbosely
    -h, --help               Show this message

Example reports


  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