watson
Command-line time tracking tool
TLDR
Start tracking
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.
