ferraus pipeline explain

Print the resolved plan with every default filled in

Synopsis

ferraus pipeline explain <input> [options] [-o <output>]

What it does

Print the resolved plan with every default filled in

Examples

Show each stage with all parameters resolved

ferraus pipeline explain job.yaml

The resolved plan as JSON, for an agent to inspect

ferraus pipeline explain job.yaml --json

See how an override changes the plan

ferraus pipeline explain job.yaml --set stages.clean.args.amount=12dB

Options

FlagTypeDefaultMeaning
--settext—Override any field before explaining Repeatable.

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
4Unsupported format or codec
8Cancelled
70Internal error (bug)

Common mistakes

  • Forgetting that outputs are never overwritten: pass --overwrite or a new -o path when re-running.

For models

  • MCP tool: ferraus_pipeline_explain
  • Schema: ferraus schema pipeline explain
  • Pipeline: { op: pipeline explain, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "pipeline explain", "defaults": {}}