omarskalli / pv

A command-line interface to Pivotal Tracker, inspired by Git

PV

Use Pivotal Tracker in the shell.

Installation

Install the binary:

$ gem install pv

Then create ~/.pv with your deets:

username: [email protected]
password: your-super-secret-password
project_id: 123456
name: 'Your Name'

Or, run pv config.

Usage

Here are all of the commands PV can do:

pv

Simply running pv will open your $PAGER with the stories in your "My Work" tab. Each story is one line and includes the title and the ID:

123456   My spoon is too big. (A Banana)

pv show 123456

Show the entire story's details, including tasks. Again, this is viewed in your $PAGER...

Feature 123456 (6 points)
Requester: A Banana <[email protected]>
Owner: John Doe <[email protected]>
Status: NOT STARTED

My spoon is too big.

I AM A BANANA!

pv edit 123456 -s {start|finish|deliver|accept|reject|restart|close} -m "message"

Edits the status of a given story on Pivotal Tracker, with an optional message. The message is appended to the story in comments.

pv {start|finish|deliver|accept|reject|restart|close} 123456 -m "message"

Easier-to-remember aliases for the above command.

pv help

Show a command manual.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request