From 9e2a0f9c08e6f4a289feada5e890e5eaff043f0d Mon Sep 17 00:00:00 2001
From: Ankit Jain <radical@gmail.com>
Date: Tue, 5 May 2026 16:41:12 -0400
Subject: [PATCH] Document installing the Aspire CLI as a NativeAOT .NET tool
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Documents the new `dotnet tool install -g Aspire.Cli` install path
introduced in Aspire 13.3 (microsoft/aspire#16496, backported in
microsoft/aspire#16611).

- Adds a new "Install as a NativeAOT .NET tool" H2 to install-cli.mdx
  with the install command, the .NET SDK 10.0.100 prerequisite, and the
  matching `dotnet tool update -g Aspire.Cli` update command.
- Notes that `aspire update --self` is disabled for .NET tool installs
  (PR 16496 redirects users to `dotnet tool update` in that case).
- Updates the page description to drop "global" — the heading and body
  use "NativeAOT .NET tool" consistently.

Refs: microsoft/aspire.dev#837 (item 1)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../content/docs/get-started/install-cli.mdx  | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/frontend/src/content/docs/get-started/install-cli.mdx b/src/frontend/src/content/docs/get-started/install-cli.mdx
index 7da9a2a31..5ec86a5ac 100644
--- a/src/frontend/src/content/docs/get-started/install-cli.mdx
+++ b/src/frontend/src/content/docs/get-started/install-cli.mdx
@@ -1,6 +1,6 @@
 ---
 title: Install Aspire CLI
-description: Learn how to install the Aspire CLI as a native executable or .NET global tool to manage your cloud-native applications.
+description: Learn how to install the Aspire CLI as a native executable or NativeAOT .NET tool to manage your cloud-native applications.
 lastUpdated: true
 tableOfContents: true
 ---
@@ -43,6 +43,24 @@ At any time, you can reopen the **Install Aspire CLI** command modal from the to
 
 You only need to download the script separately if you want to inspect it or run the installer as separate commands. For more information, see the [aspire-install script reference](/reference/cli/install-script/).
 
+## Install as a NativeAOT .NET tool
+
+<Aside type="note">
+This install method was introduced in Aspire 13.3.
+</Aside>
+
+The Aspire CLI is also published as a NativeAOT [.NET tool](https://learn.microsoft.com/dotnet/core/tools/global-tools). This install method requires the .NET SDK 10.0.100 or later.
+
+```bash title="Install the Aspire CLI as a NativeAOT .NET tool"
+dotnet tool install -g Aspire.Cli
+```
+
+Self-update via `aspire update --self` is disabled for .NET tool installs. Update the CLI through the .NET SDK instead:
+
+```bash title="Update the Aspire CLI"
+dotnet tool update -g Aspire.Cli
+```
+
 ## Validation
 
 To validate that the Aspire CLI is installed, use `aspire --version` to query Aspire CLI for a version number: