Skip to content
Dreadnode Dreadnode Dreadnode

Worlds

Manifest jobs

Section titled “Manifest jobs”

Use dn worlds manifest-create to submit a manifest generation job:

Terminal window
dn worlds manifest-create \
  --server http://127.0.0.1:8000 \
  --api-key "$DREADNODE_API_KEY" \
  --organization dreadnode \
  --workspace main \
  --name corp-ad \
  --preset small \
  --seed 7 \
  --num-users 50 \
  --num-hosts 10 \
  --domain corp.local \
  --json

Inspect durable manifests with:

Terminal window
dn worlds manifest-list
dn worlds manifest-get <manifest-id> --json
dn worlds graph-nodes <manifest-id>
dn worlds graph-edges <manifest-id>
dn worlds subgraph <manifest-id> <center-node-id>
dn worlds principals <manifest-id> --query alice
dn worlds principal <manifest-id> <principal-id>
dn worlds principal-details <manifest-id> <principal-id>
dn worlds host <manifest-id> <host-id>
dn worlds host-details <manifest-id> <host-id>
dn worlds commands <manifest-id>
dn worlds manifest-trajectories <manifest-id>

Trajectory jobs

Section titled “Trajectory jobs”

Use dn worlds trajectory-create to sample trajectories from a completed manifest:

Terminal window
dn worlds trajectory-create \
  --server http://127.0.0.1:8000 \
  --api-key "$DREADNODE_API_KEY" \
  --organization dreadnode \
  --workspace main \
  --manifest-id 11111111-2222-3333-4444-555555555555 \
  --goal "Escalate to Domain Admin" \
  --count 4 \
  --strategy smart-random \
  --mode kali \
  --json

For native agent rollouts, switch to --mode agent and provide the runtime-bound agent inputs:

Terminal window
dn worlds trajectory-create \
  --manifest-id 11111111-2222-3333-4444-555555555555 \
  --mode agent \
  --runtime-id 66666666-7777-8888-9999-aaaaaaaaaaaa \
  --capability-name dreadnode/world-operator \
  --agent-name operator

Inspect trajectories with:

Terminal window
dn worlds trajectory-list
dn worlds trajectory-get <trajectory-id> --json

Jobs

Section titled “Jobs”

The Worlds job commands cover the async control plane:

Terminal window
dn worlds job-list
dn worlds job-get <job-id> --json
dn worlds job-wait <job-id> --json
dn worlds job-cancel <job-id>

dn worlds job-wait polls until the job reaches completed, failed, or cancelled, and exits non-zero when the terminal status is not completed.