Skip to docs content

scpm query

  • Usage: scpm query [FLAGS] <SELECTOR>

Query packages in the resolved dependency graph

Arguments

<SELECTOR>

Selector expression.

Supports *, bare package names, [name=value], [version=value], [license=value], [depPath=value], [source=value], :prod, :dev, :optional, :peer, :transitive, :scripts, :bin, :deprecated, :license(value), and :type(value).

Flags

-D --dev

Only match devDependency roots and their transitive deps

-P --prod

Only match production/optional roots and their transitive deps

--json

Emit a JSON array instead of the default text layout

--parseable

Emit tab-separated rows: dep_path, name, version, source, flags

Inspired by vlt's dependency selector model, but currently local-only: selectors read scpm's lockfile graph without registry or security-service calls.

Examples:

Every reachable package

$ scpm query '*'

Exact package name

$ scpm query 'name=react'

Direct prod dependencies with install scripts

$ scpm query ':prod:scripts'

Local file/link/git/tarball dependencies

$ scpm query ':type(file), (link), (git), (remote)'

Machine-readable

$ scpm query ':bin' --json