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.Examples
# Show active operations
contree ps
# Show all operations (including completed)
contree ps -a
# UUIDs only (for scripting)
contree ps -q
# Filter by status (note: --status, not -S; -S is the global session flag)
contree ps --status 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
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
| 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 |
-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
