# 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

- [`kosa8 swarm kill`](https://docs.kosa8.com/reference/swarm-kill.md): Stop a whole swarm at once
- [`kosa8 swarm ls`](https://docs.kosa8.com/reference/swarm-ls.md): List swarms
- [`kosa8 swarm pause`](https://docs.kosa8.com/reference/swarm-pause.md): Pause every member
- [`kosa8 swarm resume`](https://docs.kosa8.com/reference/swarm-resume.md): Resume every paused member
- [`kosa8 swarm rewind`](https://docs.kosa8.com/reference/swarm-rewind.md): Put every member back to the swarm's start point
- [`kosa8 swarm send`](https://docs.kosa8.com/reference/swarm-send.md): Copy a file from one member to another, if a link allows it
- [`kosa8 swarm status`](https://docs.kosa8.com/reference/swarm-status.md): Show each member's state, egress and anomalies
- [`kosa8 swarm up`](https://docs.kosa8.com/reference/swarm-up.md): Fork a running sandbox into a swarm of N members

---
Source: https://docs.kosa8.com/reference/swarm/
