---
name: "timew-track"
section: "1"
platform: "linux"
package: "timew"
version: "1.9.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/timew-track"
---

# timew-track(1)

add intervals to the database

## 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)](/timew-hints/7.md)), 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-cancel/1.md), [**timew-continue**(1)](/timew-continue/1.md), [**timew-start**(1)](/timew-start/1.md), [**timew-stop**(1)](/timew-stop/1.md)