Skip to main content
contree ps is a top-level shortcut for operation list (contree op ls).Both share one argparse setup and one handler — ps exists for the Docker-like UX. New flags or columns added to operation list apply automatically here. See the operation - Manage operations page for the full description of dynamic columns, error handling, and multi-UUID workflows in the operation namespace.
List operations and their statuses. By default shows only active operations (PENDING, ASSIGNED, EXECUTING).

​
Examples

​
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]

Manage operations (list, inspect, cancel).

Aggregates ps/show/kill under a single namespace, and adds multi-UUID
support to “show“ and “cancel“ so several operations can be acted
on in one invocation.

Subcommands:
  list (ls)             List operations. “contree ps“ is an alias.
  show UUID [UUID…]   Show one or more operation results.
  cancel UUID [UUID…] Cancel one or more operations (or —all).

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, —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 at most this many operations, useful for —all with large history
                        (default: 1000) (default: 1000)

for coding agents:
  list/show are read-only; cancel mutates remote state
  show and cancel accept multiple UUIDs in one invocation
  show supports @N session-history references inherited from `contree show`

agent note:
  Before using this command in an automated workflow, read:
    contree agent

​
Operation statuses

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

​
Dynamic output columns

ps renders every scalar top-level field the API returns (not a fixed subset), so new server fields appear automatically. error is pinned to the last column. See operation - Manage operations for the full description.

​
See also