Swarms

What is a swarm?

Swarms are multi-agent orchestration runs driven by a YAML config. They coordinate specialized agents to collaborate on a single task.

Start a swarm and interact with it

$ dreadnode
dreadnode> /swarm ./configs/redteam-swarm.yaml
Swarm started: swarm_9f3c
dreadnode> /swarm status swarm_9f3c
Status: running (3 agents)
dreadnode> /swarm send swarm_9f3c "Focus on prompt injection vectors"
Message delivered
dreadnode> /swarm stop swarm_9f3c
Swarm stopped

YAML config overview

name: redteam-swarm
agents:
  - name: lead
    model: anthropic/claude-sonnet-4-20250514
  - name: scout
    model: openai/gpt-4.1-mini

Command reference

Command	Arguments	Description
/swarm	<config>	Start a swarm from a YAML config
/swarm list	—	List running swarms
/swarm stop	<swarm-id>	Stop a running swarm
/swarm status	<swarm-id>	Check swarm status
/swarm send	<swarm-id> <message>	Send a message to a swarm

Learn more

Extend swarm configs

For deeper YAML options, see the Extensibility section.