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 FORMAT

Specify 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 simple plain text; use csv for compliant output. The pretty-printed table 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 CHAR

Field seperator for plain/csv formats.

-l, --limit NUM

Limit the number of results.

-c, --count

Show count of results.