Skip to content
Dreadnode Dreadnode Dreadnode

Task Sets

Named, org-scoped lists of task references you can run as one evaluation.

Terminal window
$ dn task-set <command>

Named, org-scoped lists of task references — curate suites and run them as one evaluation.

init

Section titled “init”

Aliases: new

Terminal window
$ dn task-set init <name>

Scaffold a task-set.yaml manifest ready to edit and push.

Writes a commented starter manifest — every field appears with a one-line hint, so the file doubles as an entry point to the manifest contract. Edit the members, then run dn task-set push to upload.

Options

  • <name>, --name (Required) — Name for the new set (kebab-case, e.g. apex-web).
  • --path — Manifest file or a directory to write task-set.yaml into (default: ./task-set.yaml).
  • --force (default False) — Overwrite an existing manifest at the target path.

list

Section titled “list”

Aliases: ls

Terminal window
$ dn task-set list

Show task sets in your organization.

Options

  • --search, --query — Full-text search across name, description, source, and tags.
  • --tag — Filter to sets carrying this tag. Repeatable (any-of).
  • --source — Filter by source. Repeatable (any-of).
  • --contains — Filter to sets referencing a task — ‘<org>/<name>’ (any version) or ‘<org>/<name>@<version>’ (exact pinned version).
  • --limit (default 50) — Maximum results to show.
  • --include-public (default False) — Include public sets from other organizations.
  • --json (default False) — Output raw JSON instead of a summary.

info

Section titled “info”
Terminal window
$ dn task-set info <ref>

Show a task set with each member’s per-caller resolution status.

Members are resolved under your visibility at read time. Cross-org members you cannot see collapse to ‘not_found’ — the platform never discloses whether a task in another org exists (TSS-RES-004).

Options

  • <ref>, --ref (Required) — Task set to inspect (e.g. apex-web or acme/apex-web).
  • --json (default False) — Output raw JSON instead of a table.

push

Section titled “push”

Aliases: upload

Terminal window
$ dn task-set push

Create or replace a task set from a task-set.yaml manifest.

Upserts into your organization: a set with the manifest’s name is replaced in full (TSS-MUT-001), otherwise it is created. Publishing is ungated — if the result is public, any member that is not publicly runnable is surfaced as a warning but never blocks the write (TSS-VIS-002/003).

Pass --with-members to push a bundle produced by pull --with-members: every member task environment under the directory is published first (so the manifest never references tasks that don’t yet exist on the target), then the manifest is upserted. If any member fails to publish, the manifest is not written.

Options

  • <path>, --path — Manifest file or a directory containing task-set.yaml (default: ./task-set.yaml). With --with-members this must be the bundle directory.
  • --name — Override the manifest’s set name.
  • --public, --no-public — Force is_public on (—public) or off (—no-public), overriding the manifest.
  • --with-members (default False) — First publish member task environments found under the directory, then upsert the manifest.
  • --json (default False) — Output the resulting set as JSON.

add

Section titled “add”
Terminal window
$ dn task-set add <ref> <members>

Add one or more task references to an existing set.

A convenience over editing the manifest: the current set is read, the new members are appended, and the full set is written back (TSS-MUT-001 — the API has no member-level patch). Members already present are left untouched.

Options

  • <ref>, --ref (Required) — Task set to edit (e.g. apex-web or acme/apex-web).
  • <members>, --members (Required) — Task references to add, ‘<org>/<name>’ or ‘<org>/<name>@<version>’. Repeatable.

remove

Section titled “remove”
Terminal window
$ dn task-set remove <ref> <members>

Remove one or more task references from a set.

Matches members exactly: a bare ref (‘<org>/<name>’) removes the bare member, a pinned ref (‘<org>/<name>@<version>’) removes that pinned member. The set is read and rewritten in full (TSS-MUT-001).

Options

  • <ref>, --ref (Required) — Task set to edit (e.g. apex-web or acme/apex-web).
  • <members>, --members (Required) — Task references to remove. Repeatable.

pull

Section titled “pull”

Aliases: export

Terminal window
$ dn task-set pull <ref>

Export a set to a local task-set.yaml you can edit and re-push.

The reverse of push: members come down in the author’s bare/pinned form (never the read-time resolved version), so a pull/edit/push round-trip doesn’t silently pin bare references.

A set is a bookmark, not a bundle — by default only the manifest is written. Pass --with-members to also pull each member’s task environment into the target directory (one subfolder per task), producing a self-contained bundle you can carry onto an air-gapped instance and push there.

Options

  • <ref>, --ref (Required) — Task set to export (e.g. apex-web or acme/apex-web).
  • <path>, --path — File or directory to write task-set.yaml into (default: ./task-set.yaml). With --with-members this is always treated as a directory.
  • --with-members (default False) — Also pull each member’s task environment alongside the manifest.
  • --force (default False) — Overwrite an existing manifest / member directories at the target.

clone

Section titled “clone”
Terminal window
$ dn task-set clone <ref>

Copy a set into your organization under a new name.

Reads the source set (your org, or any public set from another org) and re-creates it in your org. Members carry over in their bare/pinned form; the copy starts private unless --public is passed.

Options

  • <ref>, --ref (Required) — Source set to copy (e.g. apex-web or acme/apex-web).
  • <name>, --name — Name for the copy (default: the source name).
  • --public (default False) — Make the copy public immediately.

publish

Section titled “publish”
Terminal window
$ dn task-set publish <refs>

Make one or more task sets visible to other organizations.

The set listing becomes public; member-task visibility is unchanged. Members that are not publicly runnable are surfaced as warnings (TSS-VIS-003).

Options

  • <refs>, --refs (Required)

unpublish

Section titled “unpublish”
Terminal window
$ dn task-set unpublish <refs>

Make one or more task sets private (org-only).

Options

  • <refs>, --refs (Required)

delete

Section titled “delete”

Aliases: rm

Terminal window
$ dn task-set delete <refs>

Delete one or more task sets.

Each set is hard-deleted (TSS-MUT-006). Past evaluations that referenced it keep running off their snapshots; a new evaluation against the deleted set fails with task_set_not_found.

Options

  • <refs>, --refs (Required) — Task sets to delete (e.g. apex-web or acme/apex-web). Repeatable.
  • --yes, -y (default False) — Skip the confirmation prompt.