Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A command-line interface to Pivotal Tracker, inspired by Git
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin Add Thor binary interface
lib v0.1: Project-specific configuration
spec
.gitignore Ignore real .pv files and fix broken tests
.pv.example v0.1: Project-specific configuration
.rspec
.travis.yml
Gemfile Add BugTracker and its tests
LICENSE.txt pv is pivotal tracker in the shell
README.md Add images
Rakefile v0.0.7: Filter stories that have been completed.
pv.gemspec Don't use Bundler.require. Speeds up test startup

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
Something went wrong with that request. Please try again.