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 # show all unscheduled tasks
pt started # show all started stories
pt create [title] -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] # 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> # 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] . 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).
- orta therox (Current maintainer)
- Raul Murciano (Original author)
- Anthony Crumley
- Johan Andersson
- 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 [email protected]. Copyright (C) 2011 Raul Murciano [email protected].