# kosa8 swarm up

Fork a running sandbox into a swarm of N members

## Usage

```
kosa8 swarm up NAME --from SANDBOX -n N
```

Checkpoints SANDBOX and forks it N times. Members are named NAME-1 to NAME-N
and labelled swarm=NAME. By default members may reach the internet but not
the host's LAN or any other private network. --allow limits them to the
hosts listed; --no-internet closes the network. A member cannot reach more
than the parent could: its own guest keeps the parent's rules.

No member may send files to another unless a --link allows it.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--allow` | stringSlice | only let members reach these hosts (repeat, or comma-separate) | `[]` |
| `--count, -n` | int | number of members | `3` |
| `--from` | string | running sandbox to fork (required) |  |
| `--link` | stringArray | let members matching FROM send files to members matching TO (FROM:TO, globs allowed) | `[]` |
| `--no-internet` | bool | close the network to every member |  |

## Example

```
  kosa8 swarm up triage --from agent-base -n 3
  kosa8 swarm up triage --from agent-base -n 3 --allow api.openai.com
  kosa8 swarm up triage --from agent-base -n 4 --link 'triage-*:triage-4'
```

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