Skip to content

Usage:

Terminal
$ vlt query
$ vlt query <query> --view=[human | json | mermaid | gui]

List installed dependencies matching the provided query.

Examples

Query packages with the name “foo”

Terminal
$ vlt query '#foo'

Query all peer dependencies of workspaces

Terminal
$ vlt query '*.workspace > *.peer'

Query all direct project dependencies with a “build” script

Terminal
$ vlt query ':project > *:attr(scripts, [build])'

Query packages with names starting with “@vltpkg”

Terminal
$ vlt query '[name^="@vltpkg"]'

Check for malware in dependencies

Terminal
$ vlt query ':malware'

Find packages with critical security issues

Terminal
$ vlt query ':malware(critical), :cve(*), :eval'

Options

view

Output format. Defaults to human-readable or json if no tty.

--view=[human | json | mermaid | gui]

expect-results

Set expected result count for automation and CI/CD pipelines. Exits with error code if expectation is not met.

--expect-results=<comparison>

Examples:

  • --expect-results=0 - Expect no results (useful for security checks)
  • --expect-results=">0" - Expect at least one result
  • --expect-results="<5" - Expect fewer than 5 results
  • --expect-results=">=10" - Expect 10 or more results
Terminal
# Security check that fails if malware is found
$ vlt query ':malware' --expect-results=0
# Ensure at least one workspace exists
$ vlt query ':workspace' --expect-results=">0"