timew

Start tracking an activity

$ timew start

$ timew tag [activity_tag]

$ timew start [activity_tag]

$ timew stop

$ timew track [start_time] - [end_time] [activity_tag]

$ timew summary

$ timew summary :[today|yesterday|week|lastweek|month|lastmonth|year|lastyear]

timew command [parameters]

start []
    Starts tracking time with the specified tags. If no tags are provided, uses the previously started tags.

stop []
    Stops tracking time. If tags are specified, they are associated with the ended interval.

tag
    Adds the specified tags to the currently active interval.

untag
    Removes the specified tags from the currently active interval.

summary
    Displays a summary of tracked time, grouped by tags.

report
    Generates a detailed report of tracked time.

export
    Exports the tracked time data in JSON format.

edit
    Opens the data file in your configured editor.

config
    Manages Timewarrior's configuration.

rules
    Manages Timewarrior's rules.

delete
    Deletes time intervals.

annotate
    Annotate time intervals.

help
    Displays help information.

Timewarrior (timew) is a sophisticated time tracking tool that allows you to record and analyze the time you spend on various tasks. It provides a flexible and intuitive interface for starting, stopping, and modifying time intervals associated with descriptive tags.

Unlike simpler time trackers, timew offers features such as automatic interval merging, exclusion of non-productive time (vacation, sick days), comprehensive reporting, and data visualization. It uses a rule-based engine to categorize time intervals and generates summaries, reports, and customizable charts. This makes it valuable for project management, personal productivity analysis, and billing purposes. The tool integrates with the command line, making it easily scriptable and customizable to suit individual workflows. Timew stores data in a plain text format, allowing for easy access and modification if needed.

Timew stores data in plain text files, usually located in ~/.timewarrior. The main data file is typically named data. This allows for direct inspection and manipulation of the data (with caution).

The configuration file, usually located at ~/.timewarrior/timewarrior.cfg, controls various aspects of timew's behavior, such as the data directory, editor, and report settings.

Timewarrior is using an expression language to address intervals. For example, 'today', 'yesterday', 'last week', '3 days ago', 'id:123' and even arithmetic operations like 'today - 2days'.

task(1)