dotnet-tool-run - Man Page

Invokes a local tool.

dotnet tool run

This article applies to: ✔️ .NET Core 3.1 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.

Info

2025-09-15 .NET Documentation