Save filter

Save a named filter as YAML in the repository; an existing name replaces that filter.

Command filter.save. Writes files in the working tree, never to Git. It is refused while the workspace is read-only. Checks the sort of the filter against the metamodel, which is missing or faulty.

Input

Field	Type	Required	Description
`name`	`name`	yes	Name of a saved filter, unique in the workspace ignoring case (spec-frage #363); used to call it (`selection.filter`). Saving under an existing name replaces that filter.
`description`	`string`	no
`view`	`view`	no	`core`, a variant ID, or absent for all. A variant’s view: the core requirements it neither excludes nor replaces, plus those valid for it; elements without validity property are in every view (SR-043).
`where`	`condition`	yes	Checked as in a selection; element references are written as UUIDs.
`sort`	array of `sortKey`	no	Order of element.list with this filter when its input gives no sort.

Output

Field	Type	Required	Description
`files`	array of `string`	yes
`problems`	array of `problem`	no

App

In the command prompt (Ctrl+Shift+P, macOS ⌘⇧P): the command Save filter.

CLI

reqseq filter save, with --json for the output as JSON. Its help:

Usage: reqseq filter save <name> [options]

Save a named filter as YAML in the repository; an existing name replaces that
filter.

Options:
  --name <value>          instead of the argument <name>
  --description <value>
  --view <value>
  --input <json|@file|->  command input as JSON: inline, from a file, or from
                          standard input
  --workspace <path>      workspace root (default: nearest folder upwards with
                          reqseq-workspace.yaml)
  --json                  print exactly the command output as JSON
  --yaml                  print the whole command output as YAML, problems one
                          per line
  -h, --help              show help

Only via --input: where, sort

API

POST /v1/commands/filter.save on the local API (reqseq serve api), with the input as the JSON body; the answer is the output.

MCP

Tool filter_save of the MCP server (reqseq mcp), with the input as its arguments.