Swarm Orchestration

Initialize a swarm with npx agentic-flow hooks swarm-init, spawn agents with agent-spawn, then run task-orchestrate with your task description and execution mode. The swarm distributes work across agents 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 higher. Familiarity with distributed systems concepts is helpful but not required.

Agents share state through swarm memory using swarm.memory.store to save data under a key and swarm.memory.retrieve to read it. This lets all agents work from shared context like API schemas or task results.

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 a fallback strategy such as reassigning the failed task to another agent.