timew-track - Man Page

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)

Referenced By

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

2025-08-16 timew 1.9.0 User Manuals