Query Grammar (v0)

cfs query accepts a simple expression of space-separated filters.

Filters

  • kind:<file|category|group|role|context>

  • shard:<user-authored|system|app-support|all>

  • actor:<name>

  • role:<name>

  • creator:<name>

  • category:<name>

  • token:<role>=<value> — match a name token (e.g. token:basename=pcss)

  • link:<assoc-type> — nodes that participate in that association type

  • text:<substring> — substring match across name tokens

Experimental (not in v0 CLI)

These filters are reserved for edition-aware navigation. Parsers may accept and ignore them until editions land; do not invent alphanumeric path hacks instead. See Editions and Shell query surface.

  • edition:<id|name> — constrain results to a named edition binding

  • fork:<id|name> — synonym for edition: (legacy wording)

Examples

cfs query "shard:user-authored token:basename=pcss"
cfs query "kind:file category:Documents"
cfs query "link:generated-from"
# experimental:
cfs query "edition:agent-try-3 kind:file category:Documents"