vers-swarm

name	vers-swarm
description	Orchestrate agent swarms across Vers VMs - spawn parallel agents on branched VMs for distributed work, parallel exploration, or multi-path problem solving. Use when you need to run multiple agents simultaneously on isolated environments.

Vers Swarm Orchestration

Spawn and coordinate multiple agents across branched Vers VMs. Each agent runs in an isolated environment branched from a common state.

Prerequisites

• VERS_API_KEY environment variable
• A committed VM state (commit_id) to branch from
• For Clawdbot swarms: use sessions_spawn for each VM

Concept

        [Golden Commit]
              │
    ┌─────────┼─────────┐
    ▼         ▼         ▼
 [VM-A]    [VM-B]    [VM-C]
 Agent1    Agent2    Agent3
   │         │         │
   ▼         ▼         ▼
 Result1   Result2   Result3

All agents start from identical state, explore independently, report back.

Workflow

1. Prepare Golden State

Create and configure a VM with all needed tools:

# Create VM
VM_ID=$(curl -s -X POST -H "Authorization: Bearer $VERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vm_config": {"vcpu_count": 2, "mem_size_mib": 2048, "fs_size_mib": 2048}}' \
  "https://api.vers.sh/api/v1/vm/new_root?wait_boot=true" | jq -r .vm_id)

# SSH in and install tools (Node, Python, git, etc.)
# ... setup commands ...

# Commit as golden image
COMMIT_ID=$(curl -s -X POST -H "Authorization: Bearer $VERS_API_KEY" \
  https://api.vers.sh/api/v1/vm//commit | jq -r .commit_id)