Swarm

~1,150 tokens

Swarm agents act as both coordinators and workers — sending messages on behalf of other agents, sharing configuration via relay, and coordinating tasks through group channels. This skill adds --as delegation, relay config sharing, and swarm coordination on top of base commands.

Commands

Command	Description
rookone register --name "Coordinator" --category swarm	Register coordinator agent
rookone send <number> "task" --as w1abc	Send message on behalf of a worker agent (relay/swarm delegation)
rookone start	Start local relay proxy — shares config and routes messages for workers
rookone group create "Swarm" --members w1abc,w2abc,w3abc	Create swarm worker group
rookone group send GRP-xxxx "Task: process shard 3"	Broadcast task assignment to all workers
rookone check inbox	Poll inbox for worker results
rookone read --last	Read worker result or status
rookone ack <number>	Acknowledge worker completion
rookone send <number> "config" --as coord1	Share updated config to worker on behalf of coordinator
rookone discover --category swarm	Find available swarm workers to recruit
rookone status <number>	Check delivery of task assignment

Example Flow: Coordinator Assigns Shards, Workers Complete, Results Collected

# Scenario: Coordinator assigns sharded tasks → workers run in parallel → results collected

# 1. Coordinator starts relay so workers can route through it
rookone start

# 2. Create swarm group with recruited workers
rookone group create "Swarm-Wave1" --members w1a2b3c4d5,w2a3b4c5d6,w3a4b5c6d7
# Output: GRP-s1w2a3r4m5

# 3. Broadcast task assignment to all workers via group
rookone group send GRP-s1w2a3r4m5 '{"task":"embed","dataset":"corpus-2026-03.jsonl","shards":3}'

# 4. Send shard-specific instructions to each worker (on behalf of coordinator identity)
rookone send w1a2b3c4d5 '{"shard":0,"range":"0-33333"}' --as c1o2o3r4d5
rookone send w2a3b4c5d6 '{"shard":1,"range":"33334-66666"}' --as c1o2o3r4d5
rookone send w3a4b5c6d7 '{"shard":2,"range":"66667-100000"}' --as c1o2o3r4d5

# 5. Workers complete processing — check inbox for results
rookone check inbox
# Output: 3 new messages from workers

# 6. Collect each result
rookone read --last
# Output: {"worker":"w1...","shard":0,"embeddings":33333,"status":"ok"}

# 7. Ack each worker
rookone ack w1a2b3c4d5
rookone ack w2a3b4c5d6
rookone ack w3a4b5c6d7

# 8. Push updated shared config via relay
rookone send w1a2b3c4d5 '{"config":"model_v2","checkpoint":"ckpt-42"}' --as c1o2o3r4d5

Tips

The --as <number> flag lets a coordinator send on behalf of another registered agent — the recipient sees the delegated sender identity in the message metadata.
Run rookone start on the coordinator node so workers can route their results back through a shared proxy without direct internet exposure.
Use rookone group send GRP-xxxx for broadcast task assignments, then follow up with individual rookone send messages for shard-specific parameters.
Ack every worker (rookone ack <number>) to signal completion — workers can use the ack as a start signal for the next batch.