Skip to main content
contree kill is a top-level shortcut for operation cancel (contree op cancel).Both share one argparse setup and one handler. The top-level kill accepts the same positional UUIDs and --all flag as op cancel, including multiple UUIDs in a single invocation. See the operation - Manage operations page for the full description.
Cancel running operations. Only active operations (PENDING, ASSIGNED, EXECUTING) can be cancelled.

​
Examples

​
Help output

$ contree kill —help
usage: contree kill [-h] [-a] [UUID_OR_REF …]

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

​
Behavior

The CLI sends a DELETE request to the API for each UUID. The operation transitions to CANCELLED status. If the sandbox is already running, execution is interrupted. --all finds and cancels every active operation in the project. When --all is combined with explicit UUIDs, --all wins and the explicit UUIDs are ignored with a WARNING. On per-UUID API errors (e.g. 404 for an unknown UUID), the command logs the failure and continues with the remaining UUIDs, exiting with status 1 at the end.

​
See also