watson

Track time spent on projects and tasks

TLDR

Start monitoring time in project

$ watson start [project]

Start monitoring time in project with tags

$ watson start [project] +[tag]

Stop monitoring time for the current project

$ watson stop

Display the latest working sessions

$ watson log

Edit most recent frame

$ watson edit

Remove most recent frame

$ watson remove

watson start [project [tags...]]
watson stop
watson status
watson log [options]
watson report [options]
watson projects [options]
watson tags [options]
watson edit [id]

PARAMETERS

start [project [tags...]]
    Starts a new time tracking session for the specified project, optionally with tags.

stop
    Stops the currently active time tracking session.

status
    Displays the current status of Watson, showing if a session is active and for which project.

log [options]
    Lists all recorded time frames. Options can be used to filter by date, project, or tags.

report [options]
    Generates a report summarizing time spent on different projects and tags. Options control the report format and timeframe.

projects [options]
    Lists all tracked projects.

tags [options]
    Lists all used tags.

edit [id]
    Allows editing an existing time frame with the specified ID.

DESCRIPTION

watson is a command-line application designed for time tracking. It allows users to easily start and stop timers for various projects and activities, providing a detailed log of how time is spent. Watson utilizes a simple and intuitive interface making time tracking efficient and straightforward. It enables users to generate reports, analyze their time allocation, and identify areas for improvement. This tool supports basic command arguments like starting and stopping a timer, listing existing frames, and generating reports. It aims to replace the need for cumbersome spreadsheets or complicated time tracking applications, offering a lightweight and accessible solution for individuals and small teams.

CONFIGURATION

Watson stores its data in a JSON file, typically located in ~/.watson. This file can be manually edited to configure settings such as default report formats or the location of the data store.

DATA STORAGE

Watson uses a simple JSON format to store the time tracking data. Each entry includes the start and stop times, the project name, and any associated tags. This makes it relatively easy to export and manipulate the data using external tools.