mirror of
https://github.com/jbranchaud/til
synced 2026-01-02 22:58:01 +00:00
36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# Do Project Time Tracking From The CLI
|
|
|
|
The [`watson` CLI utility](https://github.com/jazzband/Watson) is built to help
|
|
track time across projects right from the terminal. It is written in Python and
|
|
can be installed via `brew` or `pip3`.
|
|
|
|
To start tracking a new or existing project, I can specify it by name like so:
|
|
|
|
```bash
|
|
$ watson start my-project +reporting
|
|
Starting project my-project [reporting] at 00:28
|
|
```
|
|
|
|
This starts a timer for the `my-project` project and includes the tag
|
|
`reporting`. Tags are optional but can give some context to what part of a given
|
|
project this time session is for.
|
|
|
|
At any point during a session, we can check the status.
|
|
|
|
```bash
|
|
$ watson status
|
|
Project my-project [reporting] started 14 seconds ago (2025.11.14 00:28:31-0600)
|
|
```
|
|
|
|
And when we are done working on that project for the time being, we can stop it.
|
|
|
|
```bash
|
|
$ watson stop
|
|
Stopping project my-project [reporting], started a minute ago and stopped just now. (id: e8e8ed5)
|
|
```
|
|
|
|
Once we're ready to start another session (`timeframe`), we just need to run
|
|
`watson start ...` again.
|
|
|
|
See `watson --help` for other subcommands provided by the utility.
|