kosa8 docs

Commands / kosa8 swarm

kosa8 swarm

Run a group of agents forked from one sandbox, under one policy

A swarm is a group of sandboxes forked from one prepared sandbox. The parent is checkpointed first; that checkpoint is the swarm's start point, which kosa8 swarm rewind returns every member to.

Every member gets the same egress policy. Members cannot reach each other over the network: each is its own VM on its own private network, and the host's LAN is closed to them. They can pass files only with kosa8 swarm send, and only where a --link allows it. Every send is in the audit log, allowed or not.

kosa8 compares the members' egress and flags what stands out: a host only one member tried, a member sending far more than the rest, a burst of refused connections. Each is written to the audit log once. Block a host for every sandbox with kosa8 threat block.

Example

  kosa8 swarm up triage --from agent-base -n 3
  kosa8 swarm status triage
  kosa8 swarm kill triage

Subcommands