I use watson as a CMD tool for tracking time. watson is a Python app. Below you can find a reference of the commands I use to manage my work time with watson. I use this utility on Linux (Oracle Entreprise Linux) and macOS.
Record Work Sessions
Add time to a project with tag(s) that was not tracked live
$ watson add --from "2018-03-20 12:00:00" --to "2018-03-20 13:00:00" programming +addfeature
Restart another session on same project and tag
restart another session with the same project and tags as the last one:
watson restart
Starting project CLIENT1 [CLIENT] at 22:12
Restart another session on same project and tags from the moment last one ended
watson restart -G
Starting project ODAA Europe Del Lead [BD] at 17:57
Stop the existing session
Stop the existing session
~ % watson stop
Stopping project CLIENT1 [CLIENT], started 11 minutes ago and stopped just now. (id: b7d50df)
Stop existing session at a certain time in past
~ % watson stop --at 10:45
Stopping project ADMIN [Internal], started 6 hours ago and stopped 6 hours ago. (id: 198ff14)
Projects I am working on
List projects I am working on
% watson projects
1Z0-084
EMAIL
CLIENT1
Tags I use
List tags I use:
~ % watson tags
CLIENT
INTERNAL
training
log command: display recorded sessions
Last weeks sessions
By default, the sessions from the last 7 days are printed.
Monday 28 April 2025 (5h 20m 52s)
689b858 11:00 to 16:21 5h 20m 52s CLIENT1 [CLIENT]
Friday 25 April 2025 (24h 31m 26s)
6639db5 10:21 to 14:04 3h 42m 35s CLIENT1 [CLIENT]
103acb4 18:19 to 15:08 20h 48m 51s CLIENT1 [CLIENT]
Thursday 24 April 2025 (7h 39m 24s)
f790f09 10:45 to 18:24 7h 39m 24s CLIENT1 [CLIENT]
Wednesday 23 April 2025 (11h 00m 15s)
b0c463f 10:45 to 18:21 7h 36m 18s CLIENT1 [CLIENT]
1bf1f65 20:22 to 23:46 3h 23m 57s CLIENT1 [CLIENT]
Tuesday 22 April 2025 (5h 28m 10s)
514de13 10:56 to 14:00 3h 04m 37s CLIENT1 [CLIENT]
c0c181d 16:18 to 17:57 1h 38m 57s CLIENT1 [CLIENT]
5f2f789 18:24 to 19:09 44m 36s EMAIL [INTERNAL]
Monday 21 April 2025 (1h 28m 20s)
af765e2 10:05 to 11:28 1h 23m 08s CLIENT1 [CLIENT]
341e7b9 16:38 to 16:43 05m 12s CLIENT1 [CLIENT]
(END)
