This article applies to: ✔️ .NET Core 3.1 SDK and later versions
Contents
Arguments
• PACKAGE_ID
Lists the tool that has the supplied package ID if the tool is installed. Can be used in conjunction
with options. Provides a way to check if a specific tool was installed. If no tool with the specified
package ID is found, the command lists headings with no detail rows. The command always returns 0.
Description
The dotnettoollist command provides a way for you to list .NET global, tool-path, or local tools in‐
stalled on your machine. The command lists the package name, version installed, and the tool command.
To use the command, you specify one of the following:
• To list global tools installed in the default location, use the --global option
• To list global tools installed in a custom location, use the --tool-path option.
• To list local tools, use the --local option or omit the --global, --tool-path, and --local options.
• To list a specific tool, use the optional PACKAGE_ID argument.
Dotnet Tool List
Thisarticleappliesto: ✔️ .NET Core 3.1 SDK and later versions
Examples
• dotnettoollist-g
Lists all global tools installed user-wide on your machine (current user profile).
• dotnettoollist--tool-pathc:\global-tools
Lists the global tools from a specific Windows directory.
• dotnettoollist--tool-path~/bin
Lists the global tools from a specific Linux/macOS directory.
• dotnettoollist or dotnettoollist--local
Lists all local tools available in the current directory.
• dotnettoollist-gdotnetsay
Lists the global tool with the package id dotnetsay (https://www.nuget.org/packages/dotnetsay/)
• dotnettoollistdotnetsay
Lists the local tool with the package id dotnetsay (https://www.nuget.org/packages/dotnetsay/)
Name
dotnet-tool-list - Lists all .NET tools of the specified type currently installed on your machine.
Options
• -g|--global
Lists user-wide global tools. Can’t be combined with the --tool-path option. Omitting both --global
and --tool-path lists local tools.
• -?|-h|--help
Prints out a description of how to use the command.
• --local
Lists local tools for the current directory. Can’t be combined with the --global or --tool-path op‐
tions. Omitting both --global and --tool-path lists local tools even if --local is not specified.
• --tool-path<PATH>
Specifies a custom location where to find global tools. PATH can be absolute or relative. Can’t be
combined with the --global option. Omitting both --global and --tool-path lists local tools.
See Also
• .NET tools
• Tutorial: Install and use a .NET global tool using the .NET CLI
• Tutorial: Install and use a .NET local tool using the .NET CLI
2024-10-02 dotnet-tool-list(1)
Synopsis
dotnet tool list -g|--global
dotnet tool list --tool-path <PATH>
dotnet tool list --local
dotnet tool list [<PACKAGE_ID>]
dotnet tool list
dotnet tool list -h|--help
