Skip to content

aube list

  • Usage: aube list [FLAGS] [PATTERN]
  • Aliases: ls

Print the installed 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)

--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.

--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.

Examples:

$ aube list [email protected] /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 [email protected] /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/[email protected]/node_modules/express /home/user/project/node_modules/.aube/[email protected]/node_modules/lodash

Filter to a single package

$ aube list express

MIT Licenseen.devCopyright © 2026 en.dev