From ab856fc347463c9bb1fafcf92515dc854ec491ac Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Fri, 30 Jan 2026 08:47:08 -0600 Subject: [PATCH 1/4] Add deprecation notice for AI Shell --- .../AIShell/concepts/what-is-a-command-shell.md | 3 ++- .../AIShell/developer/agent-architecture.md | 2 ++ .../AIShell/developer/create-ollama-agent.md | 2 ++ .../AIShell/developer/deploy-azure-openai.md | 2 ++ .../AIShell/developer/ollama-agent-readme.md | 2 ++ .../AIShell/get-started/aishell-powershell.md | 2 ++ .../AIShell/get-started/aishell-standalone.md | 2 ++ .../docs-conceptual/AIShell/how-to/agent-azure.md | 2 ++ .../docs-conceptual/AIShell/how-to/agent-openai.md | 2 ++ .../AIShell/how-to/aishell-reference.md | 2 ++ .../docs-conceptual/AIShell/how-to/mcp-support.md | 2 ++ reference/docs-conceptual/AIShell/install-aishell.md | 2 ++ reference/docs-conceptual/AIShell/overview.md | 2 ++ reference/docs-conceptual/AIShell/release-notes.md | 2 ++ reference/includes/aishell-deprecated.md | 11 +++++++++++ reference/ps-modules/AIShell/AIShell.md | 2 ++ reference/ps-modules/AIShell/Invoke-AICommand.md | 2 ++ reference/ps-modules/AIShell/Invoke-AIShell.md | 2 ++ reference/ps-modules/AIShell/Resolve-Error.md | 2 ++ reference/ps-modules/AIShell/Start-AIShell.md | 2 ++ 20 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 reference/includes/aishell-deprecated.md 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 index d1558be..0de9b50 100644 --- 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 index 79af59c..113ee33 100644 --- 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 index d7505d3..06d26b2 100644 --- 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 index 2e3e3c9..e15e1ef 100644 --- 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 index fcd2e96..7c0d1db 100644 --- 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 index 731297b..944432f 100644 --- 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 index 855ffd0..4eff350 100644 --- 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 index 83baec3..7509c73 100644 --- 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 index f812dda..c8ab4a8 100644 --- 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 index 36c1a3c..1339c56 100644 --- 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 index 79e0241..d8d057e 100644 --- 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 index ddd3b95..5ee7049 100644 --- 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 index 1851785..22f75e4 100644 --- a/reference/docs-conceptual/AIShell/overview.md +++ b/reference/docs-conceptual/AIShell/overview.md @@ -7,6 +7,8 @@ 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. diff --git a/reference/docs-conceptual/AIShell/release-notes.md b/reference/docs-conceptual/AIShell/release-notes.md index d89b7c8..1012ef3 100644 --- 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 new file mode 100644 index 0000000..e3cec37 --- /dev/null +++ b/reference/includes/aishell-deprecated.md @@ -0,0 +1,11 @@ +--- +author: sdwheeler +ms.author: sewhee +ms.date: 01/30/2026 +ms.topic: include +--- + + +> [!NOTE] +> 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 index ca69d72..adeb652 100644 --- 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 index 5cdd319..713a107 100644 --- a/reference/ps-modules/AIShell/Invoke-AICommand.md +++ b/reference/ps-modules/AIShell/Invoke-AICommand.md @@ -21,6 +21,8 @@ Invoke-AICommand [-Command] [] ## 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 index cc96593..5c566e3 100644 --- a/reference/ps-modules/AIShell/Invoke-AIShell.md +++ b/reference/ps-modules/AIShell/Invoke-AIShell.md @@ -46,6 +46,8 @@ Invoke-AIShell [-Exit] [] ## 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 index 61304da..66d1e1f 100644 --- a/reference/ps-modules/AIShell/Resolve-Error.md +++ b/reference/ps-modules/AIShell/Resolve-Error.md @@ -20,6 +20,8 @@ Resolve-Error [-Agent ] [-IncludeOutputFromClipboard] [] [] ## 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. From 78576f74800290bf536cb4050f0ce5da8ceb3cdc Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Fri, 30 Jan 2026 08:53:31 -0600 Subject: [PATCH 2/4] Change alert type --- reference/includes/aishell-deprecated.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/includes/aishell-deprecated.md b/reference/includes/aishell-deprecated.md index e3cec37..378b750 100644 --- a/reference/includes/aishell-deprecated.md +++ b/reference/includes/aishell-deprecated.md @@ -6,6 +6,6 @@ ms.topic: include --- -> [!NOTE] +> [!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. From 0ed456706a3d78c2ff9a6d6375842d1e0ff18eb7 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Fri, 30 Jan 2026 08:56:10 -0600 Subject: [PATCH 3/4] Remove project status paragraph --- reference/docs-conceptual/AIShell/overview.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/reference/docs-conceptual/AIShell/overview.md b/reference/docs-conceptual/AIShell/overview.md index 22f75e4..c1194ef 100644 --- a/reference/docs-conceptual/AIShell/overview.md +++ b/reference/docs-conceptual/AIShell/overview.md @@ -1,7 +1,7 @@ --- 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 --- @@ -40,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: From 72b1aba8c2170e02ecfe5831b07d5414f0c100da Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Fri, 30 Jan 2026 08:59:50 -0600 Subject: [PATCH 4/4] Remove contribution paragraphs --- reference/docs-conceptual/AIShell/overview.md | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/reference/docs-conceptual/AIShell/overview.md b/reference/docs-conceptual/AIShell/overview.md index c1194ef..1d4ef1c 100644 --- a/reference/docs-conceptual/AIShell/overview.md +++ b/reference/docs-conceptual/AIShell/overview.md @@ -55,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. - [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 -