kosa8 docs

Commands / kosa8 swarm up

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.

Options

FlagTypeWhat it doesDefault
--allowstringSliceonly let members reach these hosts (repeat, or comma-separate)[]
-n, --countintnumber of members3
--fromstringrunning sandbox to fork (required)—
--linkstringArraylet members matching FROM send files to members matching TO (FROM:TO, globs allowed)[]
--no-internetboolclose 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'