I’ve been a Pivotal Tracker user for some time now and I’ve recently moved my code to GitHub, so I was interested when I found John Metta’s article which talks about automatically updating the progress of PT stories using a post-commit hook.
To get it set up you need to:
- Get an API token from Pivotal Tracker
- Scroll to the ‘API TOKEN’ section at the bottom of your profile page.
- If you don’t already have a token, click the ‘Create New Token’ button.
- Add the token to the service hooks on the GitHub repository
- Click on the settings tab for the repository
- Go to the Service Hooks section
- Scroll down the list of available service hooks and click on PivotalTracker
- Paste in your token
- Click ‘Update settings’
Now you’re ready to update your stories by including the special syntax in the commit message, specifying the story ID and (optionally) an action:
[fixes|completes|finishes|delivers #123456] My commit message
(Pivotal Tracker API Help Page)