Skip to content

aube list

  • Usage: aube list [FLAGS] [PATTERN]
  • Aliases: ls
  • Effect: read-only

Print the resolved dependency tree

Arguments

  • [PATTERN] — Optional package name (or glob-like prefix match) to filter the output

Flags

  • -D --dev — Show only devDependencies

  • -g --global — List globally-installed packages instead of the project's dependency tree

  • -P --prod — Show only production dependencies (skip devDependencies)

    Aliases: --production

  • --depth <DEPTH> — How deep to render the transitive tree.

    0 (default) shows only the top-level direct deps. Pass 9999 (or any large number) for the full graph; --depth=Infinity is accepted for pnpm/npm compat. --depth=-1 (pnpm spelling) lists project headers only — no direct or transitive deps.

    Default: 0

  • --format <FORMAT> — Output format: one of default, json, or parseable

    Choices: default, json, parseable

    Default: default

  • --json — Shortcut for --format json.

    Emit a JSON array of package entries.

  • --lockfile-only — List packages from the lockfile only, without checking node_modules.

  • --long — Show version and path for each entry.

    Default output is already name + version; --long adds the store path for debugging.

  • --parseable — Shortcut for --format parseable.

    Emit one tab-separated line per package.

  • -h --help — Print help

Examples:

$ aube list my-app@1.0.0 /home/user/project

dependencies: ├── express 4.19.2 ├── lodash 4.17.21 └── zod 3.23.8

devDependencies: ├── typescript 5.4.5 └── vitest 1.6.0

Show the full transitive tree

$ aube list --depth Infinity my-app@1.0.0 /home/user/project

dependencies: ├─┬ express 4.19.2 │ ├── accepts 1.3.8 │ ├── body-parser 1.20.2 │ └── ...

Only direct production deps

$ aube list --prod

Machine-readable: one path per line (real store locations)

$ aube list --parseable /home/user/project /home/user/project/node_modules/.aube/express@4.19.2/node_modules/express /home/user/project/node_modules/.aube/lodash@4.17.21/node_modules/lodash

Filter to a single package

$ aube list express

MIT LicensejdxCopyright © 2026 jdx.dev