watson

Command-line time tracking tool

TLDR

Start tracking

$ watson start [project] +[tag]

Stop tracking

$ watson stop

Show current status

$ watson status

List today's entries

$ watson log -d

List this week

$ watson log -w

Show report

$ watson report

Edit last entry

$ watson edit

Cancel current tracking

$ watson cancel

SYNOPSIS

watson command [options] [args]

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.