operation - Manage operations

usage: contree operation [-h] {list,ls,show,sh,cancel,kill,k,wait,w} …

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).

positional arguments:
  {list,ls,show,sh,cancel,kill,k,wait,w}
    list (ls)           List operations
    show (sh)           Show one or more operation results
    cancel (kill, k)    Cancel one or more operations
    wait (w)            Wait for operations to reach a terminal status

options:
  -h, —help            show this help message and exit

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

usage: contree operation list [-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. “contree ps“ is an alias of this command.

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)

for coding agents: read-only command

usage: contree operation show [-h] [—raw] UUID_OR_REF [UUID_OR_REF …]

Fetch and display the result of each given operation. Same per-UUID behaviour as `contree show`:
terminal results are cached; @N references resolve against session history.

positional arguments:
  UUID_OR_REF  Operations to inspect. Accepts UUIDs and session-history references: @ or HEAD for
               the active branch tip, @N for an absolute history id, @-N or HEAD~N for N steps
               back, @+N for N steps forward.

options:
  -h, —help   show this help message and exit
  —raw        Print each operation’s full server payload as JSONL (one JSON object per line) to
               stdout, verbatim. Skips formatter routing and derived columns; streams cleanly into
               `jq -c`. Useful for debugging or for fields the table view omits.

for coding agents: read-only command accepts multiple UUIDs; each rendered as its own row

usage: contree operation wait [-h] [-a] [-t TIMEOUT] [UUID_OR_REF …]

Poll the given operations until each reaches a terminal status (SUCCESS, FAILED, CANCELLED) and
print one row per completion. With —all, waits for every currently active operation (PENDING,
ASSIGNED, EXECUTING).

positional arguments:
  UUID_OR_REF           Operations to wait for. Accepts UUIDs and session-history references
                        (HEAD, HEAD~N, @, @N, @-N, @+N, :N, bare N).

options:
  -h, —help            show this help message and exit
  -a, —all             Wait for every active operation
  -t, —timeout TIMEOUT
                        Fail with exit code 1 if not all operations reach a terminal status within
                        this many seconds (default: 60)

for coding agents: read-only command (polls the API; no state mutation) fails with exit code 1 if
—timeout is hit before all complete exit code 1 also when any operation finished non-SUCCESS

usage: contree operation cancel [-h] [-a] [UUID_OR_REF …]

Cancel each given operation. With —all, cancels every active operation (PENDING, ASSIGNED,
EXECUTING).

positional arguments:
  UUID_OR_REF  Operations to cancel. Accepts UUIDs and session-history references (HEAD, HEAD~N,
               @, @N, @-N, @+N, :N, bare N).

options:
  -h, —help   show this help message and exit
  -a, —all    Cancel every active operation

for coding agents: mutating command pass UUIDs to cancel specific operations or —all for
everything