CLI reference / workdirs

stado workdirs

Invocation

stado workdirs [OPTIONS]

Purpose

Preview every directory directly under ~/.stado/work, including job and run areas. --apply removes them all, even when active

Required inputs and options

Input or optionContract
--applyDelete all listed directories; root-level files and links stay unless --include-files is given
--include-filesAlso remove the loose files and links directly at the root, so the scratch root itself ends up empty. Links are unlinked, never followed
--jsonEmit the machine-readable report

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Delete all listed directories; root-level files and links stay unless --include-files is given
  • 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.