[New article]: one-shot dotnet tool execution with `dotnet tool exec`

[baronfel]

Proposed topic or title

We need new conceptual docs on dotnet tool exec in 10.0.100-preview.6

Location in table of contents.

No response

Reason for the article

dotnet tool exec is a one-shot tool invocation mode similar to npx, where the SDK will download the tool immediately before execution if necessary. We need to document how to use this mode, and how it differs from the existing global and local tool installation modes.

Article abstract

• how to use it (dotnet tool exec [@])
• how it works
  • downloads package to nuget cache and invokes it without modifying PATH
• how it interacts with local tools
  • if the tool is in your local tool config, uses the version from there. otherwise gets latest (or the version specified on the command line)

Reference implementation PR is dotnet/sdk#49329, with a design doc at dotnet/designs#334

Relevant searches

No response