pivotal_tools is a geeky command-line interface with additional scrum, planning poker, and changelog generation features.
pip install pivotal_tools
Add PIVOTAL_TOKEN to your environment.
If you use zsh, you could put it in ~/.zshenv, like so:
export PIVOTAL_TOKEN='your token'
Also make sure in your pivotal project settings that you have “Allow API Access” checked (currently the default behavior).
All commands take the following options:
List out projects stories that are delivered or finished (not accepted)
Lists all stories for a given project (will prompt you if not specified).
pivotal_tools browser_open <story_id>
Will open the given story in a browser.
pivotal_tools scrum
Will list stories and bugs that team members are working on. Grouped by team member.
pivotal_tools poker
pivotal_tools planning # equivalent
Help to facilitate a planning poker session.
pivotal_tools create feature
pivotal_tools create bug
pivotal_tools create chore
Create a story.
pivotal_tools start story <story_id>
pivotal_tools finish story <story_id>
pivotal_tools deliver story <story_id>
pivotal_tools accept story <story_id>
pivotal_tools reject story <story_id>
Change the state of a story.
Usage:
pivotal_tools changelog [--project-index=<pi>]
pivotal_tools show_stories [--project-index=<pi>] [--for=<user_name>] [--number=<number_of_stories>]
pivotal_tools show_story <story_id> [--project-index=<pi>]
pivotal_tools browser_open <story_id> [--project-index=<pi>]
pivotal_tools scrum [--project-index=<pi>]
pivotal_tools poker [--project-index=<pi>]
pivotal_tools planning [--project-index=<pi>]
pivotal_tools create (feature|bug|chore) <title> [<description>] [--project-index=<pi>]
pivotal_tools (start|finish|deliver|accept|reject) story <story_id> [--project-index=<pi>]
Options:
-h --help Show this screen.
--for=<user_name> Username, or initials
--project-index=<pi> If you have multiple projects, this is the index that the project shows up in my prompt
This is useful if you do not want to be prompted, and then you can pipe the output