Skip to main content

ops orch

Orchestrator Agent interface. Connects to the ADW (Autonomous DevOps Worker) orchestrator agent for triggering and monitoring ADW workflows. The ADW pipeline processes digest tasks through planning, implementation, and PR creation.

ADW Pipeline Phases

The ADW pipeline processes digest tasks through phases: classify → plan → implement → commit → PR → review. Use ops orch adws to see recent workflow runs and their current phase.

Subcommands

SubcommandDescription
statusCheck orchestrator agent health and status
triggerTrigger a new ADW workflow
agentsList managed agents
adwsList recent ADW workflows
eventsStream real-time events from orchestrator WebSocket

ops orch status

Verify the orchestrator agent is up and reachable. Use this before triggering workflows if you suspect connectivity issues.

Check orchestrator agent health
Terminal
$ops orch status

ops orch trigger

Kick off a new ADW workflow for a specific digest task. The orchestrator will classify the task and route it through the appropriate phase chain.

Trigger an ADW workflow for digest task 42
Terminal
$ops orch trigger --task-id 42
Real Work Items

Triggering an ADW workflow creates ADO work items, branches, and pull requests. Confirm the task id before running.


ops orch agents

List every agent the orchestrator currently manages, along with its role and health.

Show managed agents and their state
Terminal
$ops orch agents

ops orch adws

Show recent ADW workflow runs, including phase progression and outcomes. This is the workflow-level audit trail.

List recent ADW workflows with phase status
Terminal
$ops orch adws

ops orch events

Stream live events from the orchestrator over WebSocket. Useful when watching a workflow progress in real time.

Subscribe to the orchestrator event stream
Terminal
$ops orch events

Common Workflows

🚀

Trigger and Watch

Run ops orch trigger --task-id N in one terminal, then ops orch events in another to watch phases tick over.

📋

Workflow Audit

ops orch adws shows the last several workflow runs — handy for confirming a PR was opened end-to-end.

🩺

Health Check

Start with ops orch status when something looks stuck. If the orchestrator is down, nothing downstream will move.

Pair with Digest Tasks

Digest task ids come from ops digest tasks. They are distinct from ADO work item numbers — the orchestrator creates the ADO work item as part of the workflow.