Task Search#
Usage#
hyper-shell
task
search
[-h]
[FIELD [FIELD ...]]
[--where COND [COND ...]]
[--order-by FIELD [--desc]]
[-x | --json | --csv]
[--count | --limit NUM]
Description#
Search for tasks in database.
A database must be configured.
Fields will be columns in the output.
Options relate to SQL concepts.
For single column output, use -x
/--extract
to disable
formatting and quotations (useful for piping output).
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 'exit_status != 0'
).-s
,--order-by
FIELDOrder results by field.
-x
,--extract
Disable formatting for single column output.
--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'
.--json
Format output as JSON.
--csv
Format output as CSV.
-l
,--limit
NUMLimit number of returned results.
-c
,--count
Only print number of results that would be returned.