Docs/Multi-agent

Agent Swarm

An autonomous network of three agents — Builder, Verifier and Auditor.

Agent Swarm (AgentMesh, AgentMeshModal.tsx) runs three roles together in the background — optionally inside an isolated Git worktree sandbox.

Roles

Verifier — prepares tests for the goal and runs the verify command every round.
Builder — writes the code and fixes its own build and test failures.
Auditor — once every test passes, reviews the git diff for security, architecture and edge cases. If it finds problems (AUDIT_STATUS: REJECTED), it sends file- and line-level findings back to the Builder.

Cost limit

Set a US dollar limit with budgetUsd. When the real usage cost reported by the agents reaches it, the run stops safely.

Run it from the terminal

orchestrate mesh "Add a JWT refresh token to user login" \
  --builder claude \
  --verifier agy \
  --auditor claude \
  --verify-cmd "npm test" \
  --max-rounds 3