You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/core/tools/dotnet-tool-exec.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ ms.date: 09/06/2025
5
5
---
6
6
# dotnet tool exec
7
7
8
-
**This article applies to:** ✔️ .NET 10.0.100-preview.6 SDK and later versions
8
+
**This article applies to:** ✔️ .NET 10.0.100 SDK and later versions
9
9
10
10
## Name
11
11
@@ -27,21 +27,21 @@ dotnet tool exec -h|--help
27
27
28
28
## Description
29
29
30
-
The `dotnet tool exec` command provides a one-shot tool invocation mode for .NET Tools. It automatically downloads the specified tool package to the NuGet cache and invokes it without modifying your system PATH or requiring permanent installation.
30
+
The `dotnet tool exec` command provides a one-shot tool invocation mode for .NET Tools. It automatically downloads the specified tool package to the NuGet cache and invokes it without modifying your system `PATH` or requiring permanent installation.
31
31
32
32
When you run `dotnet tool exec`, the command:
33
33
34
-
1. Checks the version (or version range) you specify (or the latest version if none is specified) against your configured NuGet feeds to decide which package to download
35
-
2. Downloads the specified package to the NuGet cache (if not already present)
36
-
3. Invokes the tool with any provided arguments
37
-
4. Returns the tool's exit code
34
+
1. Checks the version (or version range) you specify (or the latest version if none is specified) against your configured NuGet feeds to decide which package to download.
35
+
2. Downloads the specified package to the NuGet cache (if not already present).
36
+
3. Invokes the tool with any provided arguments.
37
+
4. Returns the tool's exit code.
38
38
39
39
`dotnet tool exec` works seamlessly with both global and local tools. If you have a local tool manifest available, it uses the manifest to determine which version of the tool to run.
40
40
41
41
This command also exists in two other forms for easier use
42
42
43
-
*`dotnet dnx` - a hidden alias for `dotnet tool exec` that is mostly used to give us a point to easily implement the
44
-
*`dnx` - a shell script that invokes `dotnet dnx` from the SDK. This script is provided by the installer and is available on the PATH. It allows for very simple use of Tools directly via `dnx <toolname>`.
43
+
*`dotnet dnx` - A hidden alias for `dotnet tool exec` that is mostly used to as a point to easily implement the ???
44
+
*`dnx` - A shell script that invokes `dotnet dnx` from the SDK. This script is provided by the installer and is available on `PATH`. It allows for very simple use of tools directly via `dnx <toolname>`.
45
45
46
46
## Arguments
47
47
@@ -61,11 +61,11 @@ This command also exists in two other forms for easier use
61
61
62
62
-**`--add-source <SOURCE>`**
63
63
64
-
Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. See [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). This can be controlled through the use of NuGet Package Source Mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping).
64
+
Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). You can control this through the use of NuGet package source mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping).
65
65
66
66
-**`--configfile <FILE>`**
67
67
68
-
The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior).
68
+
The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file are used. If not specified, the hierarchy of configuration files from the current directory are used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior).
69
69
70
70
-**`--disable-parallel`**
71
71
@@ -77,7 +77,7 @@ This command also exists in two other forms for easier use
77
77
78
78
-**`--interactive`**
79
79
80
-
Allows the command to stop and wait for user input or action. For example, to complete authentication. This is defaulted to `true` when the command detects that it's being run directly by a user.
80
+
Allows the command to stop and wait for user input or action, for example, to complete authentication. This option defaults to `true` when the command detects that it's being run directly by a user.
81
81
82
82
-**`--no-http-cache`**
83
83
@@ -117,7 +117,7 @@ This command also exists in two other forms for easier use
117
117
118
118
## Comparison with other commands
119
119
120
-
This command is intended to be a unified way to work with .NET Tools. While the previously-available Tool installation commands remain available, we think that`dotnet tool exec` provides a simpler and more flexible experience for most users.
120
+
This command is intended to be a unified way to work with .NET Tools. While the previouslyavailable tool installation commands remain available, `dotnet tool exec` provides a simpler and more flexible experience for most users.
Copy file name to clipboardExpand all lines: docs/core/tools/global-tools-how-to-use.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ This tutorial teaches you how to install and use a global tool. You use a tool t
16
16
* Complete the [first tutorial of this series](global-tools-how-to-create.md).
17
17
* .NET 10.0.100 SDK or later (for `dnx`) - optional but recommended.
18
18
19
-
## Run the tool without installation (Recommended)
19
+
## Run the tool without installation (recommended)
20
20
21
21
Starting with .NET 10.0.100, you can run .NET tools without permanent installation using [`dnx`](dotnet-tool-exec.md):
22
22
@@ -28,7 +28,7 @@ Starting with .NET 10.0.100, you can run .NET tools without permanent installati
28
28
29
29
The `--add-source` parameter tells the .NET CLI to use the *./nupkg* directory as an additional source feed for NuGet packages when the tool is not available on NuGet.org.
30
30
31
-
## Use the tool as a global tool (Traditional installation)
31
+
## Use the tool as a global tool (traditional installation)
32
32
33
33
If you prefer permanent installation for frequent use:
Copy file name to clipboardExpand all lines: docs/core/tools/local-tools-how-to-use.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,7 +55,7 @@ The tools listed in a manifest file are available to the current directory and s
55
55
56
56
When you use a CLI command that refers to a local tool, the SDK searches for a manifest file in the current directory and parent directories. If it finds a manifest file, but the file doesn't include the referenced tool, it continues the search up through parent directories. The search ends when it finds the referenced tool or it finds a manifest file with `isRoot` set to `true`.
57
57
58
-
## Install botsay as a local tool (Traditional approach)
58
+
## Install botsay as a local tool (traditional approach)
59
59
60
60
Install the tool from the package that you created in the first tutorial:
61
61
@@ -93,7 +93,7 @@ The *.config/dotnet-tools.json* file now has one tool:
93
93
94
94
Once installed as a local tool, you can invoke it in multiple ways:
95
95
96
-
1. Run the tool directly using `dnx`:
96
+
- Run the tool directly using `dnx`:
97
97
98
98
```dotnetcli
99
99
dnx microsoft.botsay --add-source ./nupkg hello from the bot
@@ -102,13 +102,13 @@ Once installed as a local tool, you can invoke it in multiple ways:
102
102
> [!NOTE]
103
103
> When using dnx with a local tool manifest, it automatically uses the version specified in the manifest.
0 commit comments