list report is a customizable report, which means that many aspects of the report is configurable.
You may override any of these aspects by modifying the Taskwarrior configuration.
The definition of the
list report can be shown using the
show command like this:
$ task show report.list Config Variable Value ----------------------- -------------------------------------------------------------- report.list.columns id,start.age,entry.age,depends.indicator,priority,project, tags,recur.indicator,scheduled.countdown,due,until.age, description.count,urgency report.list.description Most details of tasks report.list.filter status:pending report.list.labels ID,Active,Age,D,P,Project,Tags,R,Sch,Due,Until,Description,Urg report.list.sort start-,due+,project+/,urgency-
These are five settings that define the report. The description and labels are straightforward text.
The columns are the task metadata, with optional format specifiers.
For example, the
description.count column means the description column, but not the annotations; instead show a count of the annotations, if any.
You can see the supported columns and formats using the
The filter is automatically applied when you run this report.
In this case the filter shows only pending tasks, using
status:pending. This can cause some confusion, because if you were to run this command:
$ task status:completed list
Then the filter
status:pending, when combined with the command line filter
status:completed defines two non-intersecting sets and no result is shown.
This is because filter terms are assumed to be combined with
and operators, unless otherwise specified.
Instead, to see completed tasks, you would need to use a report that does not filter on status, and the
all report does just that, so you get the expected results by running:
$ task status:completed all
The sort setting is a list of columns, with an optional direction (ascending or descending), and an optional break indicator. A sort column need not be one that is included in the report.
There are four sort keys, which are applied in order, so the report is sorted by start date, then due date, then project, then urgency. From the example, one the third sort key is:
Breaking this down, it means the
project attribute is sorted in ascending collating sequence (hence the
+), and the solidus (
/) indicates that this is a break column, which means a blank line is inserted before every unique value.
There is a configuration option, named
print.empty.columns, which defaults to
This means that if a report has a column where no task shown has a value, then do not display this empty column.
This results in much narrower reports.
list report has thirteen columns, but due to this setting, it is rare to see more than six or seven columns in the output.