Swarm

Spawn two or more minnal agents in the same repo and the server brokers their collaboration. File reads, edits, messages, and conflict detection all happen automatically.

Why swarm

• Parallelize independent tasks across a single codebase.
• Run a planner agent and a worker agent side by side without stepping on each other.
• Get conflict notifications when agent A edits a file that agent B has read — agent B can ignore, re-read, or resolve.

Manual swarm

# Terminal 1
minnal serve

# Terminal 2 — first agent
minnal connect --name planner

# Terminal 3 — second agent in the same repo
minnal connect --name worker

Messaging

Each agent gets messaging primitives: DM another agent, broadcast to all agents on the server, or scope a broadcast to agents in the current repo.

/dm worker "Skip auth refactor — I'll handle it."
/broadcast "Pulling main, expect rebase noise."

Auto-swarm

Agents can spawn their own swarms. The swarm.spawn tool lets the active agent recruit teammates for a parallel sub-task. The original agent becomes a coordinator; minnal manages the worker group, message channels, and completion tracking — headed or headless.

Use the swarm tool to spin up 3 workers:
- one to migrate the postgres schema
- one to update the SDK clients
- one to write the changelog
Wait for all to complete, then summarize results.