TIMEW-SUMMARY(1)

🎀 TIMEW-SUMMARY(1) — User Manuals 🎀

okay so this is the timew-summary manual from the User Manuals set, and it’s literally all about showing your tracked time in a cute little table. bestie, let’s get into it 💖

---

✨ NAME ✨

timew-summary — display a time-tracking summary. slay.

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

Displays a table summarizing tracked time, by default for the current day. Accepts date ranges (or range hints) and tags, or IDs for filtering.

When IDs are given, date ranges are ignored. Specifying both, tags and IDs, is an error. so like… pick a lane, bestie 😭

💅 HINTS 💅

Apart from range hints (see timew-hints(7)), the summary report adheres to the following hints:

• :annotations, :no-annotations — Toggle the display of annotations in the summary report. Can be used on the command line to override the configured setting. The :annotations hint adds an Annotation column to the summary table. The annotation column is limited to 15 characters. Longer values in this column are truncated to 12 characters and shown with an ellipsis attached.
• :holidays, :no-holidays — Toggle the display of holidays in the summary report. Can be used on the command line to override the configured setting.
• :ids, :no-ids — Toggle the display of IDs in the summary report. Can be used on the command line to override the configured setting. The :ids hint adds an ID column to the summary table. Those ids can be used for interval modification.
• :tags, :no-tags — Toggle the display of tags in the summary report. Can be used on the command line to override the configured setting. The :tags hint adds a Tags column to the summary table.

👑 CONFIGURATION 👑

• reports.summary.annotations — Determines whether the annotation column is shown in the summary. Can be overridden by the :annotations or :no-annotations hint, respectively. Default value is 'no'.
• reports.summary.holidays — Determines whether relevant holidays are shown beneath the report. Can be overridden by the :holidays or :no-holidays hint, respectively. Default value is 'yes'.
• reports.summary.ids — Determines whether the id column is shown in the summary. Can be overridden by the :ids or :no-ids hint, respectively. Default value is 'no'.
• reports.summary.tags — Determines whether the tags column is shown in the summary. Can be overridden by the :tags or :no-tags hint, respectively. Default value is 'yes'.
• reports.summary.range — Set the date range for the summary report. The value has to correspond to a range hint, see timew-hints(7). Default value is 'day'.
• reports.summary.weekdays — Determines whether the weekday column is shown in the summary. Default value is 'yes'.
• reports.summary.weeks — Determines whether the week column is shown in the summary. Default value is 'yes'.
• tags.<tag>.color — Assigns a specific foreground and background color to a tag. Examples of valid colors include 'white', 'gray8', 'black on yellow', and 'rgb345'.

🌈 SEE ALSO 🌈

• timew-day(1)
• timew-hints(7)
• timew-lengthen(1)
• timew-modify(1)
• timew-month(1)
• timew-shorten(1)
• timew-tag(1)
• timew-untag(1)
• timew-week(1)

---

later, bestie 🫶 this page is from timew 1.9.1, dated 2025-11-02 — iconic, no cap 💅✨