dotnet tool run

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

NAME

dotnet-tool-run - Invokes a local tool.

SYNOPSIS

dotnet tool run <COMMAND NAME> [--allow-roll-forward]
dotnet tool run -h|--help

DESCRIPTION

The dotnet tool run command searches tool manifest files that are in scope for the current directory. When it finds a reference to the specified tool, it runs the tool. For more information, see Invoke a local tool.

ARGUMENTS

•: COMMAND_NAME

The command name of the tool to run.

OPTIONS

•: --allow-roll-forward

Available starting with .NET 9.0 SDK. Allow tool to use a newer version of the .NET runtime if the runtime it targets isn’t installed.

•: -?|-h|--help

Prints out a description of how to use the command.

Example

•: dotnet tool run dotnetsay

Runs the dotnetsay local tool.

•: dotnet tool run dotnetsay --allow-roll-forward

Runs the dotnetsay local tool and allows it to run on newer .NET versions if the target runtime isn’t available.