15 stable releases
new 2.0.15 | Dec 9, 2024 |
---|---|
2.0.13 | Nov 5, 2024 |
2.0.12 | Oct 28, 2024 |
2.0.8 | Sep 16, 2024 |
1.0.0 | Jul 20, 2024 |
#816 in Command line utilities
131 downloads per month
44KB
863 lines
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.
Dependencies
~19–35MB
~524K SLoC