Story Tracker CLI

CLI tool for generating story branch names and switching to them. Currently only supports Pivotal Tracker.

Providers

Pivotal Tracker

You will need to grab the API token from your profile and set it to the environment variable PIVOTAL_TRACKER_TOKEN.

Commands

Copy the link of your story, the story's ID, or the branch's name. The following formats are currently supported:

• https://www.pivotaltracker.com/story/show/12345678
• https://www.pivotaltracker.com/n/projects/12345678/stories/12345678
• #12345678
• 12345678
• feature/story-name-#12345678

Then use it like so in the following subcommands:

stb generate

stb generate https://www.pivotaltracker.com/story/show/12345678
stb gen https://www.pivotaltracker.com/story/show/12345678

Example

$ stb generate https://www.pivotaltracker.com/story/show/12345678
Getting story...
Generating branch name...
feature/story-name-#12345678

stb switch

stb switch https://www.pivotaltracker.com/story/show/12345678

Example

$ stb switch https://www.pivotaltracker.com/story/show/12345678
Fetching story 12345678...
Fetching remote branch origin/feature/story-name-#12345678...
Checking out branch master...
Pulling latest from master...
Creating branch feature/story-name-#12345678...

Additional Info

The statuses shown by the tool are sent to stderr, while only the branch name is sent to stdout. This means you can use this tool in combination with other commands like:

# Copy to clipboard
$ stb gen https://www.pivotaltracker.com/story/show/12345678 | pbcopy

Configuration

Environment Variables

PIVOTAL_TRACKER_TOKEN

This will need to reflect the token on your profile page, as seen in the Pivotal Tracker section.