Task Search#
Usage#
hyper-shell
task
search
[-h]
[FIELD [FIELD ...]]
[-w COND [COND ...]]
[-t TAG [TAG...]]
[--order-by FIELD [--desc]]
[--count | --limit NUM]
[--format FORMAT | --json | --csv]
[-d CHAR]
Description#
Search for tasks in database.
A database must be configured. Specifying FIELD names defines what is included in the output (by default all fields are included).
This command maps directly to underlying SQL queries.
Arguments#
- FIELD
Select specific named fields to include in output. Default is to include all fields.
Options#
-w
,--where
COND…List of conditional statements to filter results (e.g.,
-w 'duration >= 600'
).Operators include
==
,!=
,>=
,<=
,>
,<
,~
. The~
operator applies a regular expression.-t
,--tag
TAG…Filter on one or more tags. (e.g.,
-t special
or-t file:a
).Leaving the value unspecified will return any task for which the key exists. Specifying a full key:value pair will match on both.
-s
,--order-by
FIELD[--desc]
Order results by field. Optionally, in descending order.
--failed
Alias for
-w 'exit_status != 0'
.--succeeded
Alias for
-w 'exit_status == 0'
.--finished
Alias for
-w 'exit_status != null'
.--remaining
Alias for
-w 'exit_status == null'
.--format
FORMATSpecify output format (either
normal
,plain
,table
,csv
,json
).Default is
normal
for whole-task output. If any FIELD names are given, output is formatted in simpleplain
text; usecsv
for compliant output. The pretty-printedtable
formatting is good for presentation on wide screens.See
--csv
,--json
, and--delimiter
.--csv
Format output as CSV. (Shorthand for
--format=csv
).--json
Format output as JSON. (Shorthand for
--format=json
).-d
,--delimiter
CHARField seperator for plain/csv formats.
-l
,--limit
NUMLimit the number of results.
-c
,--count
Show count of results.