Project

ptt

0.0
No commit activity in last 3 years
No release in over 3 years
Pivotal Tracker Command Line Interface (forked from pt)
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.13
~> 5.0
~> 10.0

Runtime

~> 1.2
>= 0.7.3, ~> 0.7
>= 0.0.5, ~> 0.0.5
 Project Readme

Gem Version

pt

Minimal client to use Pivotal Tracker API v5 from the command line

Demo

asciicast

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 stories

  pt todo      <owner>                                                    # show all unscheduled stories

  pt (unscheduled,started,finished,delivered, accepted, rejected) <owner> # show all (unscheduled,started,finished,delivered, accepted, rejected) stories

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

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

  pt tasks     [id]                                                       # manage tasks of story

  pt open      [id]                                                       # open a story 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 story in points scale

  pt (start,finish,deliver,accept)     [id]                               # mark a story as started

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

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

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

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

  pt list      all                                                        # list all stories for all users

  pt updates                                                              # 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.

Problems?

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 ptt (remember to remove all sensible data though).

Contribute

  • git clone https://github.com/raul/pt.git
  • bundle
  • change the code
  • rake build
  • rake install
  • commit and create pull request

Todo

  • Add test
  • Add edit story function
  • Use ncurse for better user interface

Contributors

Thanks to...

  • the contributors of pt
  • the Pivotal Tracker guys for making a planning tool that doesn't suck and has an API
  • dashofcode for tracker_api gem
  • Bryan Liles for letting me take over the gem name

License

See the LICENSE file included in the distribution.

Copyright

Copyright (C) 2017 Slamet Kristanto cakmet14@gmail.com. Copyright (C) 2013 Orta Therox orta.therox@gmail.com. Copyright (C) 2011 Raul Murciano raul@murciano.net.