Skip to main content
Version: 5.9.x

aspect cquery

Query the dependency graph, honoring configuration flags


Executes a query language expression over a specified subgraph of the configured build dependency graph.

cquery should be preferred over query for typical usage, since it includes the analysis phase and therefore provides results that match what the build command will do.

Note that cquery is especially powerful as the graph can be processed by a purpose-built program written in Starlark. See

Aspect CLI introduces the second form, where in place of an expression, you can give a preset query name. Some preset queries also accept parameters, such as labels of targets, which can be provided as arguments. If they are absent and the session is interactive, the user will be prompted to supply these.


aspect cquery [expression |  <preset name> [arg ...]] [flags]


  -h, --help   help for cquery

Options inherited from parent commands

      --aspect:config string   User-specified Aspect CLI config file. /dev/null indicates that all further --aspect:config flags will be ignored.
--aspect:interactive Interactive mode (e.g. prompts for user input)