actx dispatch

actx dispatch

Run the orchestration dispatch engine for a specific phase. The dispatcher reads the phase gate, validates the target phase is active, and assigns ready workstreams to available agents.

Usage

actx dispatch <subcommand>

Subcommands

Subcommand	Description
run --phase <N>	Dispatch ready workstreams for the specified phase
status	Show current dispatch engine state

Options (run)

Option	Required	Description
--phase <number>	Yes	Phase number to dispatch

Examples

# Dispatch workstreams for phase 23
$ actx dispatch run --phase 23
{
  "ok": true,
  "phase": 23,
  "dispatched": [...],
  "blocked": []
}

# Check dispatch engine state
$ actx dispatch status
{
  "ok": true,
  "engine": "idle",
  "workstreams": [],
  "agents": []
}

Error Codes

Code	Meaning
PHASE_NOT_ACTIVE	The specified phase is not currently active in the phase gate
PHASE_GATE_NOT_FOUND	No docs/phase-gate.md file found in the project

See Also

• actx phase — view and manage phase gates
• actx swarm — multi-agent swarm orchestration