Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Minimal client to use Pivotal Tracker from the console.
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                                         # show all available tasks

  pt todo      <owner>                       # show all unscheduled tasks

  pt started   <owner>                       # show all started stories

  pt create    [title] <owner> <type> -m     # create a new task (and include description ala git commit)

  pt show      [id]                          # shows detailed info about a task

  pt tasks     [id]                          # manage tasks of story

  pt open      [id]                          # open a task in the browser

  pt assign    [id] <owner>                  # assign owner

  pt comment   [id] [comment]                # add a comment

  pt label     [id] [label]                  # add a label

  pt estimate  [id] [0-3]                    # estimate a task in points scale

  pt start     [id]                          # mark a task as started

  pt finish    [id]                          # indicate you've finished a task

  pt deliver   [id]                          # indicate the task is delivered

  pt accept    [id]                          # mark a task as accepted

  pt reject    [id] [reason]                 # mark a task as rejected, explaining why

  pt done      [id]  <0-3> <comment>         # lazy mans finish task, opens, assigns to you, estimates, finish & delivers

  pt find      [query]                       # looks in your tasks by title and presents it

  pt list      [owner]                       # list all tasks for another pt user

  pt list      all                           # list all tasks for all users

  pt updates   [number]                      # shows number recent activity from your current project

  pt recent                                  # shows stories you've recently shown or commented on with pt

  All commands can be run entirely without arguments for a wizard based UI. Otherwise [required] <optional>.
  Anything that takes an id will also take the num (index) from the pt command.


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).


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) 2013 Orta Therox Copyright (C) 2011 Raul Murciano

Something went wrong with that request. Please try again.