Github Issue Stats

Github issues are a decent way to track work on a small project; and with the rise of tools such as Waffle.io and ZenHub, it appears that they will slowly but surely become better and better for managing long term projects.

However statistical analysis of github issues is still very much lacking. github-stats is a command line tool / gem that takes github searches and converts them into useful project reports.

Assuming you are using Ruby 1.9.3 or above: gem install github-stats will install the tool. Running github-stats "whatever github search string you want" will run the search, outputting a closed by week report.

For a detailed list of options and command line flags, please refer to github-stats --help.

Please Note! Github's Search API restricts searches to the first 1,000 results and limits unauthenticated requests to 10 per minute. This means you can run 1 report per-minute that would return a full 1,000 issues.

I recommend using filters such as state:closed and/or updated:>=2016-01-01 to scope your requests down, based upon the report type.

The following example shows how to get a closed by week report for Rails for the first 4 weeks of May 2016

$ github-stats "repo:rails/rails type:issue is:closed closed:2016-05-01..2016-05-28"
2016-17 3 1
2016-18 27 10
2016-19 30 20
2016-20 20 25
2016-21 20 23