Add deprecation notice for AI Shell (#375)

sdwheeler · web-flow · commit 40032a7fc95d · 2026-01-30T09:10:52.000-06:00
* Add deprecation notice for AI Shell

* Change alert type

* Remove project status paragraph

* Remove contribution paragraphs
diff --git a/reference/docs-conceptual/AIShell/concepts/what-is-a-command-shell.md b/reference/docs-conceptual/AIShell/concepts/what-is-a-command-shell.md
@@ -6,6 +6,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # What is a command shell?
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 A command shell is a text-based interface for interacting with a computer, also known as a
 Read-Eval-Print Loop ([REPL][15]).
 
@@ -96,4 +98,3 @@ in Windows is an exception, as it's both a command-line tool and an interactive
 [14]: https://support.apple.com/guide/terminal/welcome/mac
 [15]: https://wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop
 [16]: https://www.gnu.org/software/bash/
-
diff --git a/reference/docs-conceptual/AIShell/developer/agent-architecture.md b/reference/docs-conceptual/AIShell/developer/agent-architecture.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # AI Shell architecture
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 ![AI Shell architecture diagram.][01]
 
 ## AIShell.Abstraction
diff --git a/reference/docs-conceptual/AIShell/developer/create-ollama-agent.md b/reference/docs-conceptual/AIShell/developer/create-ollama-agent.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Creating an Agent
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 An agent is a code library that interfaces with the AI Shell to talk to a specific large
 language model or other assistance provider. Users chat with the agents using natural language to
 get the desired output or assistance. Agents are implemented as C# classes that implement the
diff --git a/reference/docs-conceptual/AIShell/developer/deploy-azure-openai.md b/reference/docs-conceptual/AIShell/developer/deploy-azure-openai.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Deploy the Azure OpenAI Service using Bicep
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 In AIShell, the **openai-gpt** agent can be used with a public OpenAI instance or an Azure OpenAI
 deployment. We recommend using the Azure OpenAI Service because it has additional features and
 provides better manageability. This article provides the step-by-step instructions to deploy and
diff --git a/reference/docs-conceptual/AIShell/developer/ollama-agent-readme.md b/reference/docs-conceptual/AIShell/developer/ollama-agent-readme.md
@@ -6,6 +6,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Ollama Plugin
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 This agent is used to interact with a language model running locally by utilizing the Ollama API.
 Before using this agent you need to have Ollama installed and running. To create an agent, you need
 to implement the `IAgent` interface.
diff --git a/reference/docs-conceptual/AIShell/get-started/aishell-powershell.md b/reference/docs-conceptual/AIShell/get-started/aishell-powershell.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Get started with AI Shell in PowerShell
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 AI Shell was created to help command line users find the right commands to use, recover from errors,
 and better understand the commands and the output they produce. Follow along and walk through some
 examples to get started with AI Shell.
diff --git a/reference/docs-conceptual/AIShell/get-started/aishell-standalone.md b/reference/docs-conceptual/AIShell/get-started/aishell-standalone.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Get started with AI Shell
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 AI Shell was created to help command line users find the right commands to use, recover from errors,
 and better understand the commands and the output they produce. Follow along and walk through some
 examples to get started with AI Shell.
diff --git a/reference/docs-conceptual/AIShell/how-to/agent-azure.md b/reference/docs-conceptual/AIShell/how-to/agent-azure.md
@@ -6,6 +6,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Azure Copilot Agent
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 This agent is designed to connect you to the [**Azure Copilot**][02] experience directly from your
 command line. It provides assistance for Azure CLI commands, Azure PowerShell commands, and general
 Azure knowledge. To use this agent, you need to sign in to Azure using the `az login` command from
diff --git a/reference/docs-conceptual/AIShell/how-to/agent-openai.md b/reference/docs-conceptual/AIShell/how-to/agent-openai.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # OpenAI agent
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 This agent provides a user-friendly platform for interacting with OpenAI services. The OpenAI agent
 can connect to a public OpenAI service, a private deployment of the Azure OpenAI service, or any
 other OpenAI-compatible service. We recommend using an Azure OpenAI deployment for enhanced security
diff --git a/reference/docs-conceptual/AIShell/how-to/aishell-reference.md b/reference/docs-conceptual/AIShell/how-to/aishell-reference.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # AI Shell command reference
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 ## Command-line options
 
 ```
diff --git a/reference/docs-conceptual/AIShell/how-to/mcp-support.md b/reference/docs-conceptual/AIShell/how-to/mcp-support.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # MCP support
 
+[!INCLUDE[aishell-deprecated](../../../includes/aishell-deprecated.md)]
+
 Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context
 to large language models (LLMs). Starting in AI Shell 1.0.0-preview.6, AI Shell can act as an MCP
 Host and client to MCP servers. The key participants in the MCP architecture are:
diff --git a/reference/docs-conceptual/AIShell/install-aishell.md b/reference/docs-conceptual/AIShell/install-aishell.md
@@ -7,6 +7,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # Install AI Shell
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 AI Shell is an interactive shell that provides a chat interface for AI language models. For the best
 experience, install the following packages:
 
diff --git a/reference/docs-conceptual/AIShell/overview.md b/reference/docs-conceptual/AIShell/overview.md
@@ -1,12 +1,14 @@
 ---
 title: What is AI Shell?
 description: Learn about AI Shell, an interactive shell that provides a chat interface with language models.
-ms.date: 01/12/2026
+ms.date: 01/30/2026
 ms.topic: overview
 ms.collection: ce-skilling-ai-copilot
 ---
 # What is AI Shell?
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 AI Shell is an interactive shell that provides a chat interface with language models. The shell
 provides agents that connect to different AI models and other assistance providers. Users can
 interact with the agents in a conversational manner.
@@ -38,12 +40,6 @@ deeper integration with the shell. These features include:
 - Simple, single-command error recovery
 - MCP integration
 
-## Project status
-
-AI Shell is currently a preview release. Some features of the tool are still being developed and are
-subject to change. For more information about the current version and a complete list of changes,
-see the [Release notes][05].
-
 ## Known issues
 
 This current release of AI Shell has some known issues that we're actively working on addressing:
@@ -59,25 +55,6 @@ This current release of AI Shell has some known issues that we're actively worki
 - If you're using the default terminal app in macOS, you don't get the sidecar experience and the
   colors might not render correctly. It might be difficult to read the generated code.
 
-## Providing feedback
-
-Your feedback is important to us during this development phase. We encourage you to share your
-experiences to help us improve AI Shell.
-
-Here are ways you can get involved:
-
-- **File Issues:** If you encounter bugs, have suggestions for new features, or would like to report
-  inconsistencies, open an issue on the [AI Shell GitHub repository][04].
-- **Join the discussions:** Join our community discussions in the [GitHub discussions][03] tab.
-  Share ideas, discuss potential improvements, connect with other users, and share any agents you
-  create.
-- **Documentation:** If you notice any documentation gaps, you can suggest changes or submit PRs to
-  improve our documentation.
-
 <!-- link references -->
 [01]: /azure/ai-foundry/foundry-local/what-is-foundry-local
 [02]: /powershell/module/aishell/
-[03]: https://github.com/PowerShell/AIShell/discussions
-[04]: https://github.com/PowerShell/AIShell/issues
-[05]: release-notes.md
-
diff --git a/reference/docs-conceptual/AIShell/release-notes.md b/reference/docs-conceptual/AIShell/release-notes.md
@@ -8,6 +8,8 @@ ms.collection: ce-skilling-ai-copilot
 ---
 # AI Shell Release Notes
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 This document outlines the changes and improvements made in each release of AI Shell. For a more
 complete list of changes, refer to the [Releases page][06] on GitHub.
 
diff --git a/reference/includes/aishell-deprecated.md b/reference/includes/aishell-deprecated.md
@@ -0,0 +1,11 @@
+---
+author: sdwheeler
+ms.author: sewhee
+ms.date: 01/30/2026
+ms.topic: include
+---
+<!-- markdownlint-disable first-line-h1 -->
+
+> [!IMPORTANT]
+> As of January 2026, the AI Shell project is no longer being actively maintained. This project
+> should be considered archived from an engineering standpoint.
diff --git a/reference/ps-modules/AIShell/AIShell.md b/reference/ps-modules/AIShell/AIShell.md
@@ -13,6 +13,8 @@ ms.collection: ce-skilling-ai-copilot
 
 ## Description
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 The AIShell module integrates PowerShell with AIShell. This integration enables the sharing queries,
 errors, and results between PowerShell and AIShell.
 
diff --git a/reference/ps-modules/AIShell/Invoke-AICommand.md b/reference/ps-modules/AIShell/Invoke-AICommand.md
@@ -21,6 +21,8 @@ Invoke-AICommand [-Command] <ScriptBlock> [<CommonParameters>]
 
 ## DESCRIPTION
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 MCPs in AI Shell use this cmdlet to invoke a command in the connected PowerShell session. This
 command is not intended for users to directly invoke. When an AI model creates a result containing
 commands, the MCP can use this cmdlet to execute the commands in the connected PowerShell session.
diff --git a/reference/ps-modules/AIShell/Invoke-AIShell.md b/reference/ps-modules/AIShell/Invoke-AIShell.md
@@ -46,6 +46,8 @@ Invoke-AIShell [-Exit] [<CommonParameters>]
 
 ## DESCRIPTION
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 This cmdlet sends a query to the open AIShell agent and results are shown in the AIShell window.
 
 ## EXAMPLES
diff --git a/reference/ps-modules/AIShell/Resolve-Error.md b/reference/ps-modules/AIShell/Resolve-Error.md
@@ -20,6 +20,8 @@ Resolve-Error [-Agent <String>] [-IncludeOutputFromClipboard] [<CommonParameters
 
 ## DESCRIPTION
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 When an error occurs in the current session, this cmdlet sends the error to the AIShell agent for
 resolution. The command sends the full error object to the current AIShell agent session, which
 attempts to provide a resolution.
diff --git a/reference/ps-modules/AIShell/Start-AIShell.md b/reference/ps-modules/AIShell/Start-AIShell.md
@@ -21,6 +21,8 @@ Start-AIShell [-Path <String>] [<CommonParameters>]
 
 ## DESCRIPTION
 
+[!INCLUDE[aishell-deprecated](../../includes/aishell-deprecated.md)]
+
 Starts an AIShell session in a split pane window of Windows Terminal and iTerm2. The AIShell session
 is started in the right pane of the terminal window. The left pane is the current shell session. You
 must use these windows to interact with the AIShell session.
