kill - Cancel operations

Note

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

# Cancel a specific operation
contree kill 3f2a7b...

# Cancel multiple operations in one call
contree kill 3f2a7b... a1b2c3... 9d8e7f...

# Cancel all active operations
contree kill --all

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