watson: added entry

master
tiyn 5 months ago
parent 167c6b2d59
commit 2b9098a02c

@ -0,0 +1,57 @@
# Watson
[Watson](https://tailordev.github.io/Watson) is a free and open-source time-tracker for
[Linux](/wiki/linux.md) that uses the [command-line interface](/wiki/linux/shell.md).
## Setup
On most Linux distributions Watson can be installed with the `watson` package.
Additionally Watson can be installed using Pythons pip package manager.
The pip package is called ´td-watson`.
Alternatively it can be installed via [GitHub](https://github.com/TailorDev/Watson).
## Usage
The following section describes various ways of usage of Watson.
### Tracking Time and Displaying Tracked Time
Time can be tracked by running the following command.
This example tracks time to a project called `world-domination` and uses the tag `cats` and `dogs`.
Additional tags can be appended or tags can be ommited if not needed.
This should be adapted to specific needs.
```sh
watson start world-domination +cats +dogs
```
Alternatively the start time can be set in the past by adding the `--at` flag with a time.
```sh
watson start world-domination +cats +dogs --at 13:37
```
The tracking of the time can be stopped by running the following command.
```sh
watson stop
```
Afterwards the summary of the tracked time can be displayed by running the following command.
```sh
watson report
```
### Adding a Time Frame in Retrospect
It can be useful to add time frames in retrospect if the starting and stopping of that task was
forgotten at that time.
For this the following command can be run.
It works similarly to starting a time frame as explained in the
[section above](#tracking-time-and-displaying-tracked-time).
Additionally the start and stop time are specified with the `--from` and `--to` flags.
```sh
watson add --from "2018-03-20 12:00:00" --to "2018-03-20 13:00:00" programming +addfeature
```

@ -17,6 +17,6 @@ The following are program types that are generally considered useful.
Linux-based systems.
- Time-tracking software includes programs that allow its user to track the time they spent working
on a specific task or project.
- [Watson](https://tailordev.github.io/Watson/) is a free and open-source time-tracker that uses
- [Watson](/wiki/linux/watson.md) is a free and open-source time-tracker that uses
the [command-line interface](/wiki/linux/shell.md).
It is designed for Linux-based systems.

Loading…
Cancel
Save