pivotal_shell

A command-line wrapper for Pivotal Tracker

Installation

gem install pivotal_shell

Configuration

First, you need to create an API token for your profile (scroll to the bottom) and put it into ~/.pivotalrc:

api_token: abcdef0123456789

The token is the same for all of your Pivotal Tracker projects.

Second, you need to create a .pivotalrc in your project root and set up projectwide settings:

# For the https://www.pivotaltracker.com/projects/123456 project, the id would be...
project_id: 123456

# these are your initials used in the project
me: LS

Both .pivotalrc files are regular YAML files.

Usage

pivotal

Example

List all your unfinished stories

pivotal stories

List all your stories, regardless of status

pivotal stories --all --mine

List all finished stories for everyone

pivotal stories --all --finished

List all unassigned bugs

pivotal stories --unowned --bugs

Show info on a story

pivotal story 123456

TODO

Start story

pivotal start 123456

Finish story

pivotal finish 123456

Commit (with git, all comments after the story id go to git, story id gets appended to comments)

pivotal commit 123456 "some more comments"