diff --git a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
index 41d941a41..f678ca926 100644
--- a/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
+++ b/src/frontend/src/content/docs/get-started/aspire-vscode-extension.mdx
@@ -67,6 +67,10 @@ The Command Palette has commands for the most common tasks:
 - **Aspire: Open Aspire terminal** drops you into a terminal with the Aspire CLI already on `PATH` for anything the UI doesn't cover.
 - **Aspire: Update Aspire CLI** and **Aspire: Install Aspire CLI** let you manage CLI installation. **Install Aspire CLI** shows a package-manager picker (WinGet, Homebrew, npm, .NET tool, or mise, depending on your platform) plus a **Daily build (dev)** option and a link to the full [installation guide](/get-started/install-cli/) for every option, including the install script.
 
+:::note[Outdated CLI warning]
+VS Code shows a warning when it uses an Aspire CLI executable that is outdated within its release channel. This can happen when you run or debug an app, use the Aspire terminal, or run an Aspire: ... command. For example, VS Code might warn when it finds stable CLI 13.4.0 while stable 13.5.2 is available. Choose `Update Aspire CLI` to update the CLI or `Don't Show Again` to suppress warnings.
+:::
+
 ## Live editor integration
 
 When an AppHost is running, the extension paints live state directly into your editor.