Swarm Orchestration

Initialize a swarm with npx agentic-flow hooks swarm-init, spawn agents with agent-spawn, then run task-orchestrate with --mode parallel. The swarm distributes tasks across agents and aggregates results automatically.

Use mesh for peer-to-peer collaboration among equal agents, hierarchical for centralized coordination with a queen agent directing workers, and adaptive when you want the swarm to switch topology based on task complexity.

You need agentic-flow version 1.5.11 or higher and Node.js 18 or later. Familiarity with distributed systems concepts is helpful but not required.

Agents share state through swarm memory using swarm.memory.store to write data and swarm.memory.retrieve to read it. This lets all agents access shared artifacts like API schemas without direct messaging.

Coordination failures usually stem from missing memory access or disabled hooks. Verify agents can read and write swarm memory, and enable pre-task and post-task hooks for automatic synchronization.

Configure resiliency with swarm.setResiliency to set retry policies with exponential backoff and fallback behavior. Failed tasks can be automatically reassigned to other agents after the configured retry attempts.