Skip to content
This documentation is for v14 alpha, the docs for v13 stable are archived.

list

Query and inspect all dependencies in your project, both valid and invalid.

--config <file-path>

Section titled “--config ”

syncpack searches the monorepo root directory for a config file which follows its naming convention, but this can be overridden by providing a path to a specific configuration file instead.

The only requirement is that the file must have a file extension and that it is one of .cjs, .cts, .js, .json, .mjs, .mts, .ts, .yaml, or .yml.

syncpack list --config ./config/syncpack.json

--dependencies <dependency-name-pattern>

Section titled “--dependencies ”

Include dependencies whose name matches the given glob pattern.

To exclude, put a ! at the start of your query.

# Exact match for "react"
syncpack list --dependencies 'react'
# Substring match for "react"
syncpack list --dependencies '**react**'
# All dependencies under the AWS SDK scope
syncpack list --dependencies '@aws-sdk/**'
# Exact match for "react" or "webpack" (2 approaches)
syncpack list --dependencies 'react' --dependencies 'webpack'
syncpack list --dependencies '{react,webpack}'
# Substring match for "react" or "webpack"  (2 approaches)
syncpack list --dependencies '**react**' --dependencies '**webpack**'
syncpack list --dependencies '**{react,webpack}**'

--dependency-types <comma-separated-dependency-type-names>

Section titled “--dependency-types ”

Include dependencies of the given dependency types and/or custom types.

To exclude, put a ! at the start of your query.

# devDependencies only
syncpack list --dependency-types dev
# dependencies and devDependencies only
syncpack list --dependency-types dev,prod
# everything except peerDependencies
syncpack list --dependency-types '!peer'

--log-levels <comma-separated-log-level-names>

Section titled “--log-levels ”

Control how detailed the log output should be

LevelWhat is written to this channel
infoThe standard output which forms syncpack's UI, including lint issues
warnPossible mistakes in your setup, or highlights of known gaps in syncpack
errorFatal exceptions or errors outside the normal running of syncpack
debugExtremely verbose detail on why syncpack assigns each status code
# Turn off logging completely
syncpack list --log-levels off
# Only show verbose debugging logs
syncpack list --log-levels debug
# Show everything
syncpack list --log-levels error,warn,info,debug

Syncpack will print colours and clickable hyperlinks to the terminal using ANSI escape code unless this option is set.

syncpack list --no-ansi

--show <comma-separated-detail-names>

Section titled “--show ”
syncpack list --show

Change the order in which dependencies are displayed

# Sort by count, in descending order
syncpack list --sort count
# Sort A-Z by name
syncpack list --sort name

--source <file-pattern>

Section titled “--source ”

Only run syncpack list on package.json files matching the provided pattern(s).

Syncpack will look in the following places for glob patterns matching package.json files, in this order of precedence, and stop looking when a match is found:

  1. If --source CLI options are provided, use those.
  2. If source is defined in configuration, use that.
  3. If using npm workspaces or Yarn workspaces, read workspaces from ./package.json.
  4. If using pnpm, read packages from ./pnpm-workspace.yaml.
  5. If using Lerna, read packages from ./lerna.json.
  6. Default to 'package.json' and 'packages/*/package.json'.
# only the root package
syncpack list --source 'package.json'
# only packages matching a glob
syncpack list --source 'packages/beta-*'
# multiple values can be provided
syncpack list --source 'package.json' --source 'packages/beta-*'

--specifier-types <comma-separated-specifier-type-names>

Section titled “--specifier-types ”

Include only instances whose version specifiers are of the given specifier types.

To exclude, put a ! at the start of your query.

# Exact versions only
syncpack list --show instances --specifier-types exact
# Missing or unsupported versions
syncpack list --show instances --specifier-types missing,unsupported
# Latest or workspace protocol only
syncpack list --show instances --specifier-types latest,workspace-protocol

Display a list of CLI options and other help information.

# Display a short summary of commands and options
syncpack list -h
# Display full help with examples
syncpack list --help