---
name: "timew-report"
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-report"
---

# timew-report(1)

run an extension report

## 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)](/timew-hints/7.md). 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)](/timew-hints/7.md). Defaults to the value of **reports.range**.