# pt Minimal client to use Pivotal Tracker from the console. ## Setup gem install pt The first time you run it, `pt` will ask you some data about your Pivotal Tracker account and your current project. ## Usage 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 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 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. ## Problems? You can [open a new issue](https://github.com/raul/pt/issues/new). 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). # Contributors - [orta therox](http://orta.github.com) (Current maintainer) - [Raul Murciano](http://raul.murciano.net) (Original author) - [Anthony Crumley](https://github.com/craftycode) - [Johan Andersson](http://johan.andersson.net) ## Thanks to... - the contributors mentioned above and all the issue reporters - the [Pivotal Tracker](https://www.pivotaltracker.com) guys for making a planning tool that doesn't suck and has an API - [Justin Smestad](https://github.com/jsmestad) for his nice `pivotal-tracker` gem - [Bryan Liles](http://smartic.us/) for letting me take over the gem name ## License See the LICENSE file included in the distribution. ## Copyright Copyright (C) 2013 Orta Therox . Copyright (C) 2011 Raul Murciano .