Skip to content

Workflows ​

Workflows are the default operating surface for stateless agent loops.

Use workflow commands first, then drop to primitive task commands when needed.

Command Discovery ​

bash
hzl workflow list
hzl workflow show start
hzl workflow show handoff
hzl workflow show delegate

Session Decision Table ​

Session stateCommandOutcome
Agent already has in-progress workhzl workflow run start --agent <id> -P <project>Resumes one task and reports alternates
Agent has no in-progress workhzl workflow run start --agent <id> -P <project>Claims next eligible task
Work is complete and should continue elsewherehzl workflow run handoff ...Completes source, creates follow-on with carried context
Work needs another agent/subtaskhzl workflow run delegate ...Creates delegated task, adds dependency by default

Core Workflows ​

Session start ​

bash
hzl workflow run start --agent clara --project writing

Handoff with context carry ​

bash
hzl workflow run handoff \
  --from <task-id> \
  --title "Publish final copy" \
  --project marketing

Delegation with parent gating ​

bash
hzl workflow run delegate \
  --from <task-id> \
  --title "Research competitor claims" \
  --project research \
  --pause-parent

Hook delivery model ​

Completion hooks are outbox-based and non-blocking.

A host scheduler must run:

bash
hzl hook drain

Recommended cadence: every 1-5 minutes.

More workflow guides ​

HZL - Shared task ledger for OpenClaw