dotnet tool list

       This article applies to: ✔️ .NET Core 3.1 SDK and later versions

NAME

       dotnet-tool-list  - Lists all .NET tools of the specified type currently installed on your
       machine.

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

DESCRIPTION

       The dotnet tool list command provides a way for you to list  .NET  global,  tool-path,  or
       local  tools  installed  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.

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.
         The  command  returns  1  if  no  tool with the specified package ID is found; returns 0
         otherwise.

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

EXAMPLES

       • dotnet tool list -g

         Lists all global tools installed user-wide on your machine (current user profile).

       • dotnet tool list --tool-path c:\global-tools

         Lists the global tools from a specific Windows directory.

       • dotnet tool list --tool-path ~/bin

         Lists the global tools from a specific Linux/macOS directory.

       • dotnet tool list or dotnet tool list --local

         Lists all local tools available in the current directory.

       • dotnet tool list -g dotnetsay

         Lists      the      global      tool      with      the     package     id     dotnetsay
         (https://www.nuget.org/packages/dotnetsay/)

       • dotnet tool list dotnetsay

         Lists     the     local      tool      with      the      package      id      dotnetsay
         (https://www.nuget.org/packages/dotnetsay/)

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

                                            2023-10-25                        dotnet-tool-list(1)