This command will start a Pivotal Tracker story for you and create a new branch in whatever local repo you are currently in. That branch will have the PT story's id added at the end of the branch name. If you've set up the PT/GitHub integration then PT will automatically associate the branch with the story. Later, when you make a PR for that branch, you can see the PR status in the story.
See https://www.pivotaltracker.com/integrations/GitHub for more information about this integration.
This command expects a config file at $HOME/.pivotaltrackerrc to exist. That
file must look like this:
token = <your PT token here>
user_id = <your PT user id here>
You can create a token in your Pivotal Tracker user profile.
You can get your user_id by going to
https://www.pivotaltracker.com/services/v5/me. It's
the id field in the JSON response.
The tool will look stories matching the ID you provide in all the projects to which you belong.
This tool accepts the following options:
- -base - The base branch from which to create the new branch. (default "master")
- -branch - The new branch name (without the story ID).
- -id - The ID of the story to start.