Usage:
$ vlt query$ vlt query <query> --view=[human | json | mermaid | gui]
List installed dependencies matching the provided query.
Examples
Query packages with the name “foo”
$ vlt query '#foo'
Query all peer dependencies of workspaces
$ vlt query '*.workspace > *.peer'
Query all direct project dependencies with a “build” script
$ vlt query ':project > *:attr(scripts, [build])'
Query packages with names starting with “@vltpkg”
$ vlt query '[name^="@vltpkg"]'
Check for malware in dependencies
$ vlt query ':malware'
Find packages with critical security issues
$ 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
# 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"