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:

1. Get an API token from Pivotal Tracker
   1. Scroll to the ‘API TOKEN’ section at the bottom of your profile page.
   2. If you don’t already have a token, click the ‘Create New Token’ button.
2. Add the token to the service hooks on the GitHub repository
   1. Click on the settings tab for the repository
   2. Go to the Service Hooks section
   3. Scroll down the list of available service hooks and click on PivotalTracker
   4. Paste in your token
   5. 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)