LinuxCommandLibrary

watson

Command-line time tracking tool

TLDR

Start tracking

$ watson start [project] +[tag]
copy
Stop tracking
$ watson stop
copy
Show current status
$ watson status
copy
List today's entries
$ watson log -d
copy
List this week
$ watson log -w
copy
Show report
$ watson report
copy
Edit last entry
$ watson edit
copy
Cancel current tracking
$ watson cancel
copy

SYNOPSIS

watson command [options] [args]

DESCRIPTION

watson is a command-line time tracking tool that records work sessions on named projects with optional tags for categorization. Starting a timer associates the current time with a project and tags, and stopping it saves a completed time frame with the calculated duration.
The log command displays tracked entries chronologically, with filters for viewing today's work, the current week, or a specific date range. Reports aggregate time by project, showing total hours spent on each project and its tags over a given period.
Past entries can be added retroactively, existing entries can be edited to correct mistakes, and the cancel command discards the currently running timer without saving it.

PARAMETERS

start PROJECT [+TAGS]

Start tracking.
stop
Stop tracking.
status
Current frame.
log [-d|-w|-m]
Show entries.
report [-d|-w|-m]
Generate report.
edit
Edit entry.
cancel
Cancel current.
add
Add past entry.
remove
Delete entry.

CAVEATS

Single-user tool. No sync built-in. SQLite backend.

HISTORY

Watson was created for simple CLI time tracking. Named after Sherlock Holmes' companion, it helps track where time goes.

SEE ALSO

timew(1), clockify(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community