timew-start(1)

timew-start1

Start time tracking

Usage

timew start [<date>] [<tag> ...]

Overview

Begins tracking using the current time with any specified set of tags. If a tag contains multiple words, therefore containing spaces, use quotes to surround the whole tag.

Hints

The start command accepts the following hints:

:fill

The ':fill' hint can be used to create a new interval that starts right after the last closed interval. This is useful when you want to start tracking time immediately after finishing a previous task without specifying a start time.

Examples

For example, this command specifies two tags ('weekend' and 'Home & Garden'), the second of which requires quotes.

$ timew start weekend 'Home & Garden'

An optional date may be specified to indicate the intended start of the tracked time:

$ timew start 8am weekend 'Home & Garden'

If there is a previous open interval, it will be closed at the given start time.

Quotes are harmless if used unnecessarily.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

From timew 1.9.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.