Skip to content

volta list

The volta list command displays the tools available in your current toolchain. It has the following syntax:

bash
Displays the current toolchain

USAGE:
    volta list [FLAGS] [OPTIONS] [SUBCOMMAND]

FLAGS:
        --verbose    Enables verbose diagnostics
        --quiet      Prevents unnecessary output
    -h, --help       Prints help information

SUBCOMMAND:
    all             Display all the available tools
    node            Display all Node.js versions
    npm             Display all npm versions
    yarn            Display all Yarn versions
    pnpm            Display all pnpm versions (with feature flag enabled)
    packages        Display all package binaries

Examples

Listing All Tools

To see all tools in your toolchain:

bash
volta list all

This will display your default Node.js version, any package managers you've installed, and any package binaries you've installed globally.

Listing Specific Tool Types

You can also list specific types of tools:

bash
# List installed Node.js versions
volta list node

# List installed npm versions
volta list npm

# List installed Yarn versions
volta list yarn

# List installed pnpm versions (with feature flag enabled)
volta list pnpm

# List installed package binaries
volta list packages

Output Format

The volta list command organizes its output by tool type:

⚡️ Node: v16.14.2 (default)

⚡️ Package Managers:
    npm: v8.5.0 (default)
    yarn: v1.22.19 (default)

⚡️ Packages:
    typescript: v4.7.4 (default)
    eslint: v8.15.0 (default)

Each entry shows:

  • The tool name
  • Its version
  • Whether it's set as the default version

Understanding the Output

  • Default: This indicates the version that will be used when you're not in a project with pinned versions
  • Tools vs. Packages: Node.js, npm, and yarn are considered tools, while globally installed npm packages are listed under "Packages"
  • Current vs. Available: The command only shows tools that are currently installed, not all available versions

Use Cases

volta list is useful when you need to:

  1. Check which version of Node.js or package managers you have set as default
  2. Verify which global packages you've installed with Volta
  3. Confirm that a tool was successfully installed
  4. See which versions of tools you have cached locally

Released under the BSD 2-Clause License.