> ## 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.
# operation - Manage operations
Manage operations under a single namespace. Aggregates `ps` (list),
`show` (inspect), and `kill` (cancel), and adds **multi-UUID support** to
`show` and `cancel` so several operations can be acted on in one call.
`op` is the short alias.
## Subcommands
| Subcommand | Aliases | Description |
| ----------------------- | ----------- | ------------------------------------------------------------ |
| `list` | `ls` | List operations. Same flags as `contree ps`. |
| `show UUID [UUID...]` | `sh` | Show one or more operation results. |
| `wait UUID [UUID...]` | `w` | Wait for operations to reach a terminal status (or `--all`). |
| `cancel UUID [UUID...]` | `kill`, `k` | Cancel one or more operations (or `--all`). |
## Examples
```bash theme={null}
# List active operations (same as `contree ps`)
contree op list
contree op ls
contree op ls -a --status FAILED # all flags from ps are accepted
# Inspect a single operation
contree op show 3f2a7b...
# Inspect several operations at once
contree op show 3f2a7b... a1b2c3... 9d8e7f...
# History references (inherited from `contree show`)
contree op show @5 @4 @3
# Cancel one or more operations
contree op cancel 3f2a7b...
contree op cancel a1b2c3... 9d8e7f...
# Cancel every active operation
contree op cancel --all
```
## Help output
The top-level `op` command is a dispatcher: by itself it only prints
usage and routes to the three subcommands described below.
usage: contree operation \[-h] \{list,ls,show,sh,cancel,kill,k,wait,w} ...
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:
\{list,ls,show,sh,cancel,kill,k,wait,w}
list (ls) List operations
show (sh) Show one or more operation results
cancel (kill, k) Cancel one or more operations
wait (w) Wait for operations to reach a terminal status
options:
-h, --help show this help message and exit
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
\$ contree op list --help
usage: contree operation list \[-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]
List operations. \`\`contree ps\`\` is an alias of this command.
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)
for coding agents: read-only command
\$ contree op show --help
usage: contree operation show \[-h] \[--raw] UUID\_OR\_REF \[UUID\_OR\_REF ...]
Fetch and display the result of each given operation. Same per-UUID behaviour as \`contree show\`:
terminal results are cached; @N references resolve against session history.
positional arguments:
UUID\_OR\_REF Operations to inspect. Accepts UUIDs and session-history references: @ or HEAD for
the active branch tip, @N for an absolute history id, @-N or HEAD\~N for N steps
back, @+N for N steps forward.
options:
-h, --help show this help message and exit
--raw Print each operation's full server payload as JSONL (one JSON object per line) to
stdout, verbatim. Skips formatter routing and derived columns; streams cleanly into
\`jq -c\`. Useful for debugging or for fields the table view omits.
for coding agents: read-only command accepts multiple UUIDs; each rendered as its own row
\$ contree op wait --help
usage: contree operation wait \[-h] \[-a] \[-t TIMEOUT] \[UUID\_OR\_REF ...]
Poll the given operations until each reaches a terminal status (SUCCESS, FAILED, CANCELLED) and
print one row per completion. With --all, waits for every currently active operation (PENDING,
ASSIGNED, EXECUTING).
positional arguments:
UUID\_OR\_REF Operations to wait for. 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 Wait for every active operation
-t, --timeout TIMEOUT
Fail with exit code 1 if not all operations reach a terminal status within
this many seconds (default: 60)
for coding agents: read-only command (polls the API; no state mutation) fails with exit code 1 if
--timeout is hit before all complete exit code 1 also when any operation finished non-SUCCESS
\$ contree op cancel --help
usage: contree operation cancel \[-h] \[-a] \[UUID\_OR\_REF ...]
Cancel each given operation. With --all, cancels every active operation (PENDING, ASSIGNED,
EXECUTING).
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: mutating command pass UUIDs to cancel specific operations or --all for
everything