A command-line interface to Pivotal Tracker, inspired by Git
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
lib
spec
.gitignore
.pv.example
.rspec
.travis.yml
Gemfile
LICENSE.txt
README.md
Rakefile
pv.gemspec

README.md

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