ids and show are your primary human-readable inspection commands. Use ids to navigate the full set of requirement identifiers in your workspace, and show to examine every attribute of a single node in detail.
xspec ids
ids prints every requirement ID in your workspace. Without flags it produces a flat, sorted list; with --tree it renders the hierarchy.
Flags
flag
Render IDs as a nested tree that reflects the containment hierarchy of your spec files.
glob
Restrict output to nodes defined in files whose workspace-relative paths match the given glob pattern.
flag
Show only nodes that have no incoming dependency edges. Containment edges (
contains) are not counted — a node is considered unreferenced only if nothing declares a depends, embeds, or references edge pointing to it.Tree output example
Flat output example
JSON output
Pass--json to receive a JSON array of identity strings, suitable for piping into other tools.
xspec show
show prints the complete record for a single node: its identity, source byte range, tags, coverage attribute, all four content hashes, every incoming and outgoing edge grouped by kind, the node’s own text, and its full subtree text.
<node> is either path#id for a specific node, or a bare path to refer to the file root node.
Output example
Hash meanings
show vs query node
xspec show and xspec query node return the same information. show is formatted for human reading; query node always emits JSON. Use show when you are working interactively at the terminal and query node when you need machine-readable output for scripts or CI tooling.