Usage

start-feature STORYID

When given a story id, a new local feature branch will be created from your current branch. If you have a .tracker_settings.yml file in the root directory of the project, then this will mark the story as "started" in Pivotal Tracker.

finish-feature COMMITMSG

When you are done working on a feature and ready to merge it into master, use finish-feature to do a squashed merge into master and push the changes to origin/master. Additionally, COMMITMSG will be appended with [finishes #STORYID] to mark the story as "finished" in Pivotal Tracker.

Currently, this is done with Pivotal Tracker's integration with Github. See this blog post for further details on getting this set up.

start-hotfix STORYID [STABLE_BRANCH]

Creates a new local hotfix branch from STABLE_BRANCH, which defaults to stable. Currently, this command does not support Pivotal Tracker integration, though support is planned.

.tracker_settings.yml

To integrate these scripts with Pivotal Tracker, create a .tracker_settings.yml file in the root directory for the project. It should have the following info:

token: YOUR_TRACKER_API_TOKEN
project_id: TRACKER_PROJECT_ID

You should add this file to your .gitignore, as it contains user-specific settings.