Selectors

Selectors are the composable query grammar for Context Nest. They let you precisely describe which documents you want — by tag, type, status, pack, path, or any combination.

Quick reference


ctx query "tag:#engineering"                    # By tag
ctx query "type:document"                       # By type
ctx query "status:published"                    # By status
ctx query "pack:engineering-essentials"          # By pack
ctx query "path:nodes/api-*"                    # By glob path
ctx query "tag:#api & status:published"          # Intersection (AND)
ctx query "tag:#api + tag:#v2"                  # Union (OR)
ctx query "tag:#engineering - tag:#deprecated"   # Difference (NOT)
ctx query "(tag:#api | tag:#sdk) & status:published"  # Grouped

Grammar

A selector expression is composed of atoms combined with operators.


expression  = term (('+' | '|') term)*
term        = factor (('&' | '-') factor)*
factor      = atom | '(' expression ')'
atom        = tag | uri | type | status | pack | path | transport | server

See Atoms and Operators for the full reference.