Quick Start

Get your first swarm running in 5 minutes.

1. Initialize the Project

npx ruflo@latest init wizard

Follow the prompts. This creates:

npx ruflo@latest daemon start

This enables background workers and autonomous task loops.

Initialize a hierarchical swarm (recommended for learning):

npx ruflo@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized

This creates a coordinated team with a central coordinator and 7 worker agents.

npx ruflo@latest agent spawn -t coder --name my-coder

List all agents:

npx ruflo@latest agent list

Store a pattern:

npx ruflo@latest memory store --key "auth-pattern" --value "JWT with refresh tokens" --namespace patterns

Search:

npx ruflo@latest memory search --query "authentication" --namespace patterns

Open Claude Code and run a task:

@task
Analyze the src/auth module for security issues. Use the memory system to find relevant patterns.

Claude Code will:

Task	Command
Check swarm status	`npx ruflo@latest swarm status`
List all agents	`npx ruflo@latest agent list`
Stop an agent	`npx ruflo@latest agent stop <agent-id>`
Search memory	`npx ruflo@latest memory search --query "..."`
View hooks	`npx ruflo@latest hooks list`
Run benchmarks	`npx ruflo@latest performance benchmark`
Security scan	`npx ruflo@latest security scan`