dotnet-tool-run - Invokes a local tool.

dotnet tool run NAME SYNOPSIS DESCRIPTION ARGUMENTS OPTIONS Example SEE ALSO

dotnet tool run

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

SYNOPSIS

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

dotnet tool run -h|--help

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.

	•		.NET tools
	•		Tutorial: Install and use a .NET local tool using the .NET CLI