TIMEW-TRACK(1) User Manuals TIMEW-TRACK(1)

NAME

timew-track - add intervals to the database

SYNOPSIS

timew track <range> [<tag>...]

DESCRIPTION

The track command is used to add tracked time in the past. Perhaps
you forgot to record time, or are just filling in old entries.

HINTS

Apart from range hints (see timew-hints(7)), the track command
accepts the following hints:

:fill
The ':fill' hint can be used to create a new interval that fills
the gap between two adjacent intervals.

EXAMPLES

Recording a closed interval
For example:

$ timew track :yesterday 'Training Course'
$ timew track 9am - 11am 'Staff Meeting'

Note that the track command expects a closed interval (start and
end time), when recording. If a closed interval is not provided,
the 'track' command behaves the same as the 'start' command.

Filling the gap between two intervals
To fill the gap between two intervals, without having to specify
the exact times, one can use the :fill hint. When e.g. the first
interval ends some time before 10:00 and the second interval
starts some time after 11:00, calling

$ timew track 10:00 - 11:00 :fill 'Coffee Break'

will instruct Timewarrior to expand the interval such that it
starts right after the first interval and ends right before the
second interval.

SEE ALSO

timew-cancel(1), timew-continue(1), timew-start(1), timew-stop(1)

timew 1.9.1 2025-08-22 TIMEW-TRACK(1)