CLI reference / host / remove-run-directory

stado host remove-run-directory

Invocation

stado host remove-run-directory [OPTIONS] <TARGET> <PATH>

Purpose

Recursively remove one complete managed run directory. PATH must be one direct child of `$HOME/.stado/work/runs`. Absence is a retry-safe success; symlinks, foreign ownership, the shared root, and nested subdirectories are refused.

Required inputs and options

Input or optionContract
<TARGET>Positional input; required or optional as shown in the invocation.
<PATH>Absolute managed run directory on TARGET
--jsonEmit the removal receipt as JSON

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.