> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # ps - List activity **`contree ps` is a top-level shortcut for [operation list](./operation) (`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](./operation) 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 ```bash theme={null} # 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, --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 | 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](./operation) for the full description. ## See also * [operation - Manage operations](./operation) — the canonical command (`contree ps` is its shortcut) * [show - Inspect an operation](./show) — inspect a specific operation * [kill - Cancel operations](./kill) — cancel a running operation * [Scripting & Automation](../tutorial/workflows) — monitoring and scripting patterns