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).

Options

  • <path>, --path — Manifest file or a directory containing task-set.yaml (default: ./task-set.yaml).
  • --name — Override the manifest’s set name.
  • --public, --no-public — Force is_public on (—public) or off (—no-public), overriding 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.

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).
  • --force (default False) — Overwrite an existing manifest at the target path.

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.