ps - List activity

Note

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

# 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

$ 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 {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:   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

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