# kosa8 cloud swarm

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

A swarm is a named group of sandboxes forked from one prepared sandbox. The
parent is checkpointed first (the swarm's start point), then forked. Every member
runs the same egress policy, with the organization's threat feed blocked.
Pause puts every member to sleep with its state kept; kill does the same and
marks the swarm killed (--rm deletes the members instead).

## Example

```
  kosa8 cloud swarm up triage --from sbx_123 -n 10 --allow api.openai.com --no-internet
  kosa8 cloud swarm status triage
  kosa8 cloud swarm pause triage
  kosa8 cloud swarm kill triage --rm
```

## Subcommands

- [`kosa8 cloud swarm kill`](https://docs.kosa8.com/reference/cloud-swarm-kill.md): The kill switch: every member to sleep and the swarm marked killed
- [`kosa8 cloud swarm ls`](https://docs.kosa8.com/reference/cloud-swarm-ls.md): List the organization's swarms
- [`kosa8 cloud swarm pause`](https://docs.kosa8.com/reference/cloud-swarm-pause.md): Put every running member to sleep, state kept (the fast stop)
- [`kosa8 cloud swarm resume`](https://docs.kosa8.com/reference/cloud-swarm-resume.md): Wake every sleeping member
- [`kosa8 cloud swarm status`](https://docs.kosa8.com/reference/cloud-swarm-status.md): Each member's state, egress counters and anomalies
- [`kosa8 cloud swarm up`](https://docs.kosa8.com/reference/cloud-swarm-up.md): Checkpoint a sandbox and fork it into a swarm of N members

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