Subcommands¶

You can access the list of the supported subcommands by issuing:

Creating. You can create an issue using an add subcommand:
```
$ tray add <status> <priority> <energy> <time> <summary>
```
Like this:
```
$ tray add N 4 1 12 "Find some milk!"
```
Note

In versions preceding 0.05 this is usually achieved through create subcommand.

It will generate an index for the newly created file and will pass it to you as a response.
Editing. You can edit an issue:
```
$ tray edit <index> <field key> <value>
```
For example:
```
$ tray edit 20130805225109 -en 4
```
You will be then prompted for field you want to change and value sequentially. Supported fields: -en (energy), -pr (priority), -st (status), -sm (summary), tm (time). You can change multiple fields at the time, combining the tags like:
```
$ tray edit 20130805225109 -en 4 -sm "Buy the milk!"
```
Logging. You can log amount of time you have spent, working on this issue. Time is given in sessions. You can manually change lenght of one session in minutes in the configuration file. By default sessions are 25 minutes.
```
$ tray log <index> <sessions>
```
For example:
```
$ tray log 20130816164911 2
```
You can also enable a countdown, so that you could work trough sessions with a timer:
```
$ tray log -t 20130816164911 2
```
It will start printing the time left every second, until finished, or interrupted.

Note

If interrupted, the timer will not ultimately log the issues.
Reviewing. You can review all the available issues by issuing the review subcommand:
```
$ tray review
```
You can also use this subcommand to show one issue:
```
$ tray review -i <index>
```
Clearing. You can instantly clear the data folder:
```
$ tray clear
```
You can also delete only one issue with this subcommand:
```
$ tray clear -i <index>
```
Note

The .json file of the issue(s) will be deleted forever.
About. You can learn the current version of the application, using about subcommand.