<commit_before># ptt (pivotal tracker terminal)

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


## Setup

    gem install ptt

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

## Usage

Run `ptt` from the root folder of your project.

```
  ptt                                         # show all available tasks

  ptt todo      <owner>                       # show all unscheduled tasks

  ptt started   <owner>                       # show all started stories

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

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

  ptt tasks     [id]                          # manage tasks of story

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

  ptt assign    [id] <owner>                  # assign owner

  ptt comment   [id] [comment]                # add a comment

  ptt label     [id] [label]                  # add a label

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

  ptt start     [id]                          # mark a task as started

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

  ptt deliver   [id]                          # indicate the task is delivered

  ptt acceptt    [id]                          # mark a task as acceptted

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

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

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

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

  ptt list      all                           # list all tasks for all users

  ptt updates                                 # shows number recent activity from your current project

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

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

## Problems?

You can [open a new issue](https://github.com/raul/ptt/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 `ptt` (remember to remove all sensible data though).

# Contributors
- <NAME> (current maintainer of ptt)
- [orta therox](http://orta.github.com) (Current maintainer of pt)
- [<NAME>](http://raul.murciano.net) (Original author)
- [<NAME>](https://github.com/craftycode)
- [<NAME>](http://johan.andersson.net)

## Thanks to...
- the contributors of pt
- the [Pivotal Tracker](https://www.pivotaltracker.com) guys for making a planning tool that doesn't suck and has an API
- forest for 'tracker-api' gem

## License
See the LICENSE file included in the distribution.

## Copyright
Copyright (C) 2017 <NAME> <<EMAIL>>.<commit_msg>fix readme<commit_after># ptt (pivotal tracker terminal)

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


## Setup

    gem install ptt

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

## Usage

Run `ptt` from the root folder of your project.

```
  ptt                                         # show all available tasks

  ptt todo      <owner>                       # show all unscheduled tasks

  ptt started   <owner>                       # show all started stories

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

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

  ptt tasks     [id]                          # manage tasks of story

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

  ptt assign    [id] <owner>                  # assign owner

  ptt comment   [id] [comment]                # add a comment

  ptt label     [id] [label]                  # add a label

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

  ptt start     [id]                          # mark a task as started

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

  ptt deliver   [id]                          # indicate the task is delivered

  ptt acceptt    [id]                          # mark a task as acceptted

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

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

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

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

  ptt list      all                           # list all tasks for all users

  ptt updates                                 # shows number recent activity from your current project

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

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

## Problems?

[open a new issue](https://github.com/raul/ptt/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 `ptt` (remember to remove all sensible data though).

# Contributors
- <NAME> (Current maintainer of ptt)
- [orta therox](http://orta.github.com) (Current maintainer of pt)
- [<NAME>](http://raul.murciano.net) (Original author)
- [<NAME>](https://github.com/craftycode)
- [<NAME>](http://johan.andersson.net)

## Thanks to...
- the contributors of pt
- the [Pivotal Tracker](https://www.pivotaltracker.com) guys for making a planning tool that doesn't suck and has an API
- forest for 'tracker-api' gem

## License
See the LICENSE file included in the distribution.

## Copyright
Copyright (C) 2017 <NAME> <<EMAIL>>.
{'fraction_non_alphanumeric': 0.07417709782104775, 'fraction_numerical': 0.0027816411682892906, 'mean_word_length': 1.8637168141592921, 'pattern_counts': {'":': 0, '<': 33, '<?xml version=': 0, '>': 33, 'https://': 6, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 16, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2159169', 'n_tokens_mistral': 1798, 'n_tokens_neox': 1673, 'n_words': 778}