Minimal client to use Pivotal Tracker from the console.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead, 207 commits behind raul:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Minimal client to use Pivotal Tracker from the console.


gem install pt

The first time you run it, pt will ask you some data about your Pivotal Tracker account and your current project.


Run pt from the root folder of your project.

pt          # shows your "My work" tasks list

Run pt create to create a new bug, chore or feature.

The rest of the commands will open you a list of your tasks and let you interact with it:

pt show     # shows detailed info about a task

pt open     # open a task in the browser

pt assign   # assign owner

pt comment  # add a comment

pt estimate # estimate a task in points scale

pt start    # mark a task as started

pt finish   # indicate you've finished a task

pt deliver  # indicate the task is delivered

pt accept   # mark a task as accepted

pt reject   # mark a task as rejected, explaining why


You can open a new issue. It can be helpful to include a trace of the requests and responses you're getting from Pivotal Tracker: you can get it by adding the --debug parameter while invoking pt (remember to remove all sensible data though).


Anthony Crumley Johan Andersson

Thanks to...

  • the contributors mentioned above and all the issue reporters
  • the Pivotal Tracker guys for making a planning tool that doesn't suck and has an API
  • Justin Smestad for his nice pivotal-tracker gem
  • Bryan Liles for letting me take over the gem name


See the LICENSE file included in the distribution.


Copyright (C) 2011 Raul Murciano