From 1ed8f279345bc49e5cb2f4a99331915195a4f3f4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Oct 2025 05:58:07 +0000
Subject: [PATCH 1/3] Initial plan


From 02fdf6849d031d764f92d5c13e0a821331d9dd46 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Oct 2025 06:04:56 +0000
Subject: [PATCH 2/3] Add Aspire CLI pivot to upgrade guide with aspire update
 instructions

Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com>
---
 docs/get-started/upgrade-to-aspire-9.md | 57 +++++++++++++++++++++++++
 docs/zones/zone-pivot-groups.yml        |  2 +
 2 files changed, 59 insertions(+)

diff --git a/docs/get-started/upgrade-to-aspire-9.md b/docs/get-started/upgrade-to-aspire-9.md
index 9303346f8f..ccf521d254 100644
--- a/docs/get-started/upgrade-to-aspire-9.md
+++ b/docs/get-started/upgrade-to-aspire-9.md
@@ -224,6 +224,52 @@ Finalizing operation...
 Complete: 3 succeeded, 0 failed, 7 skipped.
 ```
 
+:::zone-end
+:::zone pivot="aspire-cli"
+
+To upgrade your Aspire AppHost project using the Aspire CLI, you need to install the latest version of the Aspire CLI and run the `aspire update` command.
+
+1. Install the latest release of the Aspire CLI:
+
+    # [Bash](#tab/bash)
+
+    ```bash
+    curl -sSL https://aspire.dev/install.sh | bash
+    ```
+
+    # [PowerShell](#tab/powershell)
+
+    ```powershell
+    iex "& { $(irm https://aspire.dev/install.ps1) }"
+    ```
+
+    ---
+
+    For more information, see [Install Aspire CLI](../cli/install.md).
+
+1. Navigate to your Aspire solution directory in a terminal.
+
+1. Run the `aspire update` command:
+
+    ```Aspire
+    aspire update
+    ```
+
+    The `aspire update` command scans your AppHost-based solution and updates Aspire-related NuGet packages to the latest versions. The command:
+
+    - Locates the AppHost project automatically.
+    - Prompts you to choose a channel (for example: `stable`, `preview`, or `daily`).
+    - Detects outdated Aspire packages and computes safe upgrade targets.
+    - Updates package versions and `NuGet.config` file if required.
+    - Asks for confirmation before applying changes.
+
+    :::image type="content" source="../whats-new/media/aspire-update.gif" lightbox="../whats-new/media/aspire-update.gif" alt-text="Recording of aspire update running on eShop sample.":::
+
+> [!IMPORTANT]
+> 🧪 **Preview feature**: The `aspire update` command is in preview and might change before general availability. The `aspire update` command makes changes to project files, central package management, and NuGet.config files. We recommend using version control and inspecting changes after `aspire update` is run to verify the changes.
+
+For more information, see [aspire update command](../cli-reference/aspire-update.md).
+
 :::zone-end
 
 ### Update the NuGet packages
@@ -245,6 +291,17 @@ dotnet add package Aspire.Hosting.AppHost --version 9.5.0
 
 When a package reference already exists, the `dotnet add package` command updates the reference to the specified version. For more information, see [dotnet add package](/dotnet/core/tools/dotnet-add-package).
 
+:::zone-end
+:::zone pivot="aspire-cli"
+
+When using the Aspire CLI, the `aspire update` command handles updating NuGet packages automatically. If you need to manually update packages, you can use the .NET CLI command to update the `Aspire.Hosting.AppHost` package to version `9.5.0`:
+
+```dotnetcli
+dotnet add package Aspire.Hosting.AppHost --version 9.5.0
+```
+
+For more information, see [aspire update command](../cli-reference/aspire-update.md).
+
 :::zone-end
 
 With the AppHost project updated, your project file should look like this:
diff --git a/docs/zones/zone-pivot-groups.yml b/docs/zones/zone-pivot-groups.yml
index 9bb6c5950c..5e0fc44c8e 100644
--- a/docs/zones/zone-pivot-groups.yml
+++ b/docs/zones/zone-pivot-groups.yml
@@ -43,6 +43,8 @@ groups:
     title: Visual Studio
   - id: dotnet-cli
     title: .NET CLI
+  - id: aspire-cli
+    title: Aspire CLI
 - id: resp-host
   title: Hosting resource type
   prompt: Choose a hosting resource that supports the Redis protocol

From b78c285a3e352ee9ebf6ca36b346f672e31e5f9b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 3 Oct 2025 06:08:14 +0000
Subject: [PATCH 3/3] Fix tab syntax in Aspire CLI installation instructions

Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com>
---
 docs/get-started/upgrade-to-aspire-9.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/get-started/upgrade-to-aspire-9.md b/docs/get-started/upgrade-to-aspire-9.md
index ccf521d254..f56e59d7be 100644
--- a/docs/get-started/upgrade-to-aspire-9.md
+++ b/docs/get-started/upgrade-to-aspire-9.md
@@ -231,13 +231,13 @@ To upgrade your Aspire AppHost project using the Aspire CLI, you need to install
 
 1. Install the latest release of the Aspire CLI:
 
-    # [Bash](#tab/bash)
+    ### [Bash](#tab/bash)
 
     ```bash
     curl -sSL https://aspire.dev/install.sh | bash
     ```
 
-    # [PowerShell](#tab/powershell)
+    ### [PowerShell](#tab/powershell)
 
     ```powershell
     iex "& { $(irm https://aspire.dev/install.ps1) }"