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