A simple way to integrate GitHub Issues into Pivotal Tracker
NOTICE: I haven't used Tracker in over a year, so this project is dead. I'm not actively looking for a new maintainer, but if you want to take over, you're more than welcome.
Clone the repo
git clone https://github.com/jrostand/pivothub.git
Get an OAuth key from GitHub. Instructions are available here
Set up your deployment environment. I use Heroku personally (because you get SSL for free), but it should work equally well with other providers. Note that using SSL is highly recommended as otherwise your credentials will be transmitted in the clear.
cp config.json.example config.json
You'll need to edit
config.jsonto suit your needs. Explanations of the flags are in the file.
Setting up Pivotal Tracker
This section will tell you how to set up Pivotal Tracker to pull in GitHub Issues as well as close Issues that are associated with Finished stories.
- Your application is deployed at
- Your GitHub project is at
Pulling Issues into Pivotal
Scroll down to External Tool Integrations and select
Otherfrom the options in the
Create New Integration...box
Fill in the form with this information:
- Name: Whatever you'd like to call the Issues panel (e.g., GitHub Issues)
- Basic Auth Username: The value of
basicUsernamein the config
- Basic Auth Password: The value of
basicPasswordin the config
- Base URL:
- Import API URL:
Closing Issues from Finished stories
If you would like PivotHub to close Issues that are associated with Finished stories, here's how to set that up:
In Pivotal, go to the
Configure Integrationspage for your project
Fill in the Activity Web Hook fields as follows:
- Web Hook URL:
- API Version:
- Web Hook URL:
Click Save Web Hook Settings
MIT license. See the license file.