timew-hints(7)
| TIMEW-HINTS(7) | User Manuals | TIMEW-HINTS(7) |
NAME
timew-hints - Timewarrior hints
SYNOPSIS
DESCRIPTION
Timewarrior supports hints, which are single-word command line features that start with a colon like this:
:week
Hints serve several purposes. This example is a shortcut for the date range that defines the current week.
Other hints, such as:
:quiet
are ways to control the behavior of Timewarrior, in this case eliminating all forms of feedback, for purposes of automation.
The supported hints are:
:quiet Turns off all feedback. For automation :debug Runs in debug mode, shows many runtime details :yes Overrides confirmation by answering 'yes' to the questions
:color Force color on, even if not connected to a TTY :nocolor Force color off, even if connected to a TTY :blank Leaves tracked time out of a report :fill Expand time to fill surrounding available gap :adjust Automatically correct overlaps :ids Displays interval ID numbers in the summary report
Range hints provide convenient shortcuts to date ranges:
:all All tracked time :yesterday The 24 hours of the previous day :day / :today The 24 hours of the current day :week This week :fortnight This week and the one before :month This month :quarter This quarter :year This year :lastweek Last week :lastmonth Last month :lastquarter Last quarter :lastyear Last year :monday Previous monday :tuesday Previous tuesday :wednesday Previous wednesday :thursday Previous thursday :friday Previous friday :saturday Previous saturday :sunday Previous sunday
EXAMPLES
Forcing color output
By default, Timewarrior disables color output when its
output is not a terminal (for example, when piped or run under 'watch'). One
can force color output using the ':color' hint:
timew :color day
This is particularly useful with 'watch' for live updates:
watch -c timew :color day
where '-c' preserves ANSI color codes.
| 2026-08-03 | timew 1.10.0 |