DevSpace workflows
Use a workflow when a task has a repeatable multi-agent plan. Keep one-off delegation on the subagents commands.
Named workflows live in the current project's .devspace/workflows/ directory. Run a named workflow or a specific file:
devspace workflow run --name <name> [--args '<json>']
devspace workflow run --file <path> [--args-file <path>]
The command returns a compact <workflow id="..." status="..."/> receipt. Keep the ID. Workflow code is read-only by default; add --write-mode allowed only when the workflow must modify the project.
Wait up to 60 seconds at a time. Repeat wait if the returned status is still running; do not poll status in a loop.
devspace workflow wait <id> --timeout 60
Inspect current state, calls, or one full call when needed:
devspace workflow status <id>
devspace workflow calls <id>
devspace workflow call <id> <index>
devspace workflow events <id> --after <last-sequence>
devspace workflow ls
events returns at most 100 persisted log and phase entries. Keep the highest sequence and pass it with --after for the next page.
Cancel only when the parent task no longer needs the run:
devspace workflow cancel <id>
Resume an interrupted or failed run from its durable call history:
devspace workflow run --resume <id> [--args '<json>']
Use --json only for scripts that need structured output.