Skip to content
A tool that finds buggy spots in your codebase
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.




This tool uses Pivotal to identify which commits in your project are bug fixes, then analyzes those commits in your local git project to find which parts of your codebase need more attention. This is an implementation of the bug prediction solution a Google engineer posted. The difference being that instead of relying upon git commit messages, we can use other tools to provide identification of bug fix commits.


In order to analyze your codebase, your project must have been using:

  • a git repo
  • Pivotal Tracker
  • Pivotal Tracker Integration with Github

I am hoping to have more tool integration options other than Pivotal in the future.


$ npm install -g hotspots

The global is optional.

How to Use

You can use this tool as a command line utility or as a library

$ hotspots --help

The command line tool writes the file/score data to a csv file path of your choice, for easy visualization.

var findHotspots = require('hotspots');
findHotspots('<Pivotal API Token>', '<Project ID>', '<Project Path>', function(err, scoresByFile){
	// Do something great!


I welcome all those who would like to help. All I ask is that you run your changes through the gulp eslint task before creating a pull request.

You can’t perform that action at this time.