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:
- Check which version of Node.js or package managers you have set as default
- Verify which global packages you've installed with Volta
- Confirm that a tool was successfully installed
- See which versions of tools you have cached locally