TIMEW-REPORT(1)

🌸 TIMEW-REPORT(1) — aka timew-report 🌸

okay so bestie, this is the manual page for timew-report(1), and it's literally the glow-up your extension reports have been waiting for ✨

💖 NAME 💖

timew-report — run an extension report 🫶

🦋 SYNOPSIS 🦋

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

🔥 DESCRIPTION 🔥

So this one runs an extension report, and yes it supports filtering the data, we love that for us 💅

The report command itself is optional — which means these two commands are literally the same thing, no cap:

$ timew report foo :week
$ timew        foo :week

But heads up: this does assume there's a foo extension installed. No foo, no report, iykyk 🙈

The return code is the return code of the extension — like, it just hands you back whatever the extension gave it. But if the extension produces no output and a non-zero rc, then 255 is returned. Periodt 💀

Filtering is either possible by range and/or tags, or by ids. Pick your vibe 🎀

---

✨ CONFIGURATION ✨

• reports.range — sets the default date range for all reports. The value has to correspond to a range hint, see timew-hints(7) (go read it, it's giving essential 💜). Defaults to all.
• reports.<name>.range — sets 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 — cute, right?). The value has to correspond to a range hint, see timew-hints(7). Defaults to the value of reports.range.

fr fr, if you're setting ranges without checking timew-hints(7) first, you're lowkey doing too much 😭 read the hints, bestie.

---

and that's the whole page, main character energy from start to finish 👑

sign-off szn: this diva is timew version 1.9.1, dated 2025-11-02 — screenshot it, cite it, love it 💖🌸🦋