ps

List operations and their statuses. By default shows only active operations (PENDING, ASSIGNED, EXECUTING).

Examples

# Show active operations
contree ps

# Show all operations (including completed)
contree ps -a

# UUIDs only (for scripting)
contree ps -q

# Filter by status
contree ps -S FAILED

# Filter by kind
contree ps -K instance

# Operations from the last hour
contree ps -a --since=1h

# Pipe to other commands
contree ps -q | xargs -I {} contree show {}

Help output

$ contree ps --help usage: contree ps [-h] [-q] [-a]                   [--status {P,PENDING,A,ASSIGNED,E,EXECUTING,S,SUCCESS,F,FAILED,C,CANCELLED}]                   [-k {image_import,instance}] [--since SINCE] [--until UNTIL] [-M SHOW_MAX] List operations (running and completed instances, image imports). By default shows only active operations (PENDING, ASSIGNED, EXECUTING). Use -a/--all to include completed ones, or -S/--status to filter by a specific status. Use -K/--kind to filter by operation type. Use -q/--quiet to print only UUIDs, useful for scripting. options:   -h, --help            show this help message and exit   -q, --quiet           Only show UUIDs, useful for scripting   -a, --all             Show all operations (default: active only)   --status {P,PENDING,A,ASSIGNED,E,EXECUTING,S,SUCCESS,F,FAILED,C,CANCELLED}                         Filter by status (default: EXECUTING only, unless -a is used)   -k {image_import,instance}, --kind {image_import,instance}                         Filter by operation kind   --since SINCE         Parse +/- intervals (bare seconds or smhdMy) or ISO/date to UTC datetime.   --until UNTIL         Show operations before. Parse +/- intervals (bare seconds or smhdMy) or                         ISO/date to UTC datetime.   -M SHOW_MAX, --show-max SHOW_MAX                         Show at most this many operations, useful for --all with large history                         (default: 1000) (default: 1000) for coding agents:   read-only command   default view is active operations only; use --all for full history   use -q for UUID-only output in scripts agent note:   Before using this command in an automated workflow, read:     contree agent

Operation statuses

Status

Meaning

PENDING

Queued, waiting for resources

ASSIGNED

Assigned to a worker

EXECUTING

Running

SUCCESS

Completed successfully

FAILED

Completed with an error

CANCELLED

Cancelled by the user

Without -a, only PENDING, ASSIGNED, and EXECUTING are shown.

See also