List saved filters

Saved filters of the workspace, with their definitions.

Command filter.list. Reads the workspace and changes no file.

Input

No input.

Output

Field	Type	Required	Description
`filters`	array of `object`	yes	In the order of their files. A faulty file is not listed; it is one of `problems`.
`filters[].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.
`filters[].file`	`string`	yes	The filter file, relative to the workspace root.
`filters[].description`	`string`	no
`filters[].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).
`filters[].where`	`condition`	yes	Combinable condition (SR-069). Exactly one operator per object. `all`: every condition holds (`[]` holds), `any`: some holds (`[]` does not), `not`: it does not hold.
`filters[].sort`	array of `sortKey`	no
`problems`	array of `problem`	no	Filter files that cannot be read, do not match filter.schema.json, or repeat the name of an earlier file.
`incomplete`	`incomplete`	no	True when a result is incomplete because targets are in repositories that are not available locally (SR-006 AK2, SR-036 AK3).

App

In the command prompt (Ctrl+Shift+P, macOS ⌘⇧P): the command List saved filters.

CLI

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

Usage: reqseq filter list [options]

Saved filters of the workspace, with their definitions.

Options:
  --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

API

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

MCP

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