TIMEW-REPORT(1) User Manuals TIMEW-REPORT(1)

NAME

timew-report - run an extension report

SYNOPSIS

timew [report] <report> [<range>] [<tag>...]
timew [report] <report> <id>...

DESCRIPTION

Runs an extension report, and supports filtering data. The 'report'
command itself is optional, which means that these two commands are
equivalent:

$ timew report foo :week
$ timew foo :week

This does however assume there is a 'foo' extension installed.

The return code is the return code of the extension. If the
extension produces no output and a non-zero rc, then 255 is returned.

Filtering is either possible by range and/or tags, or by ids.

CONFIGURATION

reports.range
Sets the default date range for all reports. The value has to
correspond to a range hint, see timew-hints(7). Defaults to all

reports.<name>.range
Set the date range for report name, used if no range is given on
the command line. Here, name is the name of the report
executable without its extension (i.e. a report executable
'foo.py' is referred to by 'foo'). The value has to correspond
to a range hint, see timew-hints(7). Defaults to the value of
reports.range.

timew 1.9.1 2025-08-16 TIMEW-REPORT(1)