Project

pv

0.02
No release in over 3 years
Low commit activity in last 3 years
A command-line interface to Pivotal Tracker.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

PV

Use Pivotal Tracker in the shell.

Installation

Install the binary:

$ gem install pv

Then create ~/.pv with your deets:

username: user@email.com
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 log

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

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 <banana@work.com>
Owner: John Doe <someone@home.com>
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

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