timew-retag(1)

timew-retag1

Replace all tags in intervals

Usage

timew retag [<id> ...] <tag> ...

Overview

The 'retag' command is used to replace all tags in an interval with the newly provided tags. Using the 'summary' command, and specifying the ':ids' hint shows interval IDs. Using the right ID, you can identify an interval to retag.

Examples

For example, show the IDs:

$ timew summary :week :ids

Then having selected '@2' as the interval you wish to retag:

$ timew retag @2 'New Tag'

Note that you can retag multiple intervals, with multiple tags:

$ timew retag @2 @10 @23 'Tag One' tag2 tag3

If there is active time tracking, you can omit the ID when you want to retag the current open interval:

$ timew start foo
$ timew retag bar

This results in the current interval having only the 'bar' tag.

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

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