Merge pull request #368 from MicrosoftDocs/main

sdwheeler · web-flow · commit d2a9bff998de · 2026-01-14T09:24:21.000-06:00
Auto Publish – main to live - 2026-01-12 23:03 UTC
diff --git a/.gitignore b/.gitignore
@@ -1,10 +1,22 @@
-log/
-obj/
 _site/
-.optemp/
-_themes*/
-_repo.*/
-
+_themes/
+.DS_Store
+.openpublishing.build.mdproj
 .openpublishing.buildcore.ps1
-.vscode/styles
+.optemp/
 .vale/
+.vscode/launch.json
+.vscode/styles/
+*.orig
+**/.ignore/**
+**/settings.json
+dependentPackages/
+log/
+maml/
+obj/
+packages.config
+packages/
+StaleContentReport.*.csv
+Tools/NuGet/
+updatablehelp/
+xhtml/
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
@@ -5,10 +5,13 @@
     "Acrolinx.vscode-sidebar",
     "docsmsft.docs-authoring-pack",
     "marvhen.reflow-markdown",
+    "chrischinchilla.vale-vscode",
     "ms-vscode.powershell",
+    "nhoizey.gremlins",
     "shuworks.vscode-table-formatter",
+    "bierner.markdown-yaml-preamble",
     "streetsidesoftware.code-spell-checker",
-    "wmaurer.change-case",
-    "yzane.markdown-pdf"
+    "usernamehw.errorlens",
+    "wmaurer.change-case"
   ]
 }
diff --git a/reference/.vscode/settings.json b/reference/.vscode/settings.json
@@ -0,0 +1,8 @@
+{
+    "markdownlint.config": {
+        "MD028": false,
+        "MD025": {
+            "front_matter_title": ""
+        }
+    }
+}
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
@@ -1,7 +1,8 @@
 ---
 title: What is a command shell?
-ms.date: 11/11/2024
+ms.date: 01/12/2026
 description: Learn what a command shell is and how it works.
+ms.collection: ce-skilling-ai-copilot
 ---
 # What is a command shell?
 
@@ -95,3 +96,4 @@ 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
@@ -1,10 +1,10 @@
 ---
 title: Architecture of AI Shell
 description: This article explains the architecture of AI Shell and API required to support agents.
-ms.date: 11/11/2024
+ms.date: 01/12/2026
 ms.topic: concept-article
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # AI Shell architecture
 
 ![AI Shell architecture diagram.][01]
@@ -58,3 +58,4 @@ easily merge `AIShell.App` into `AIShell.Kernel` if this idea no longer make sen
 
 <!-- link references -->
 [01]: media/agent-architecture/aishell-agent-architecture.png
+
diff --git a/reference/docs-conceptual/AIShell/developer/create-ollama-agent.md b/reference/docs-conceptual/AIShell/developer/create-ollama-agent.md
@@ -1,10 +1,10 @@
 ---
 title: How to create an agent for Ollama
 description: Learn how to create an agent for the Ollama language model in AI Shell.
-ms.date: 05/16/2025
+ms.date: 01/12/2026
 ms.topic: how-to
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # Creating an Agent
 
 An agent is a code library that interfaces with the AI Shell to talk to a specific large
@@ -503,3 +503,4 @@ folder.
 [04]: https://github.com/PowerShell/AIShell/tree/main/shell/agents/AIShell.Ollama.Agent
 [05]: https://github.com/PowerShell/AIShell/blob/main/shell/README.md
 [06]: https://www.nuget.org/packages/AIShell.Abstraction
+
diff --git a/reference/docs-conceptual/AIShell/developer/deploy-azure-openai.md b/reference/docs-conceptual/AIShell/developer/deploy-azure-openai.md
@@ -1,8 +1,9 @@
 ---
 title: Deploy the Azure OpenAI Service using Bicep
 description: This article provides the step-by-step instructions to deploy and instance of the Azure OpenAI Service using Bicep.
-ms.date: 01/15/2025
+ms.date: 01/12/2026
 ms.topic: concept-article
+ms.collection: ce-skilling-ai-copilot
 ---
 # Deploy the Azure OpenAI Service using Bicep
 
@@ -192,3 +193,4 @@ for Azure OpenAI deployments, see [Azure OpenAI Service documentation][03].
 [05]: /powershell/azure/install-azure-powershell
 [06]: https://medium.com/medialesson/deploy-an-azure-openai-service-with-llm-deployments-via-bicep-244411472d40
 [07]: https://raw.githubusercontent.com/PowerShell/AIShell/refs/heads/main/docs/development/AzureOAIDeployment/main.bicep
+
diff --git a/reference/docs-conceptual/AIShell/developer/ollama-agent-readme.md b/reference/docs-conceptual/AIShell/developer/ollama-agent-readme.md
@@ -1,7 +1,8 @@
 ---
 title: Ollama agent README
 description: Learn how to use the Ollama agent in AI Shell.
-ms.date: 03/03/2025
+ms.date: 01/12/2026
+ms.collection: ce-skilling-ai-copilot
 ---
 # Ollama Plugin
 
@@ -40,4 +41,4 @@ There is an updated version of the Ollama agent available in the AI Shell reposi
 [01]: https://github.com/ollama/ollama
 [02]: https://github.com/ollama/ollama?tab=readme-ov-file#model-library
 [03]: https://github.com/ollama/ollama?tab=readme-ov-file#start-ollama
-[04]: https://github.com/PowerShell/AIShell/blob/v1.0.0-preview.2/shell/agents/AIShell.Ollama.Agent/README.md
+[04]: https://github.com/PowerShell/AIShell/blob/v1.0.0-preview.2/shell/agents/AIShell.Ollama.Agent/README.md
diff --git a/reference/docs-conceptual/AIShell/get-started/aishell-powershell.md b/reference/docs-conceptual/AIShell/get-started/aishell-powershell.md
@@ -1,8 +1,9 @@
 ---
 description: This article explains how to install and configure AI Shell, and get started chatting with an AI assistant in PowerShell.
-ms.date: 11/11/2024
+ms.date: 01/12/2026
 title: Get started with AI Shell in PowerShell
 ms.topic: get-started
+ms.collection: ce-skilling-ai-copilot
 ---
 # Get started with AI Shell in PowerShell
 
@@ -131,3 +132,4 @@ This command allows you to interact with the AI model from your working terminal
 [04]: media/aishell-powershell/resolve-error.gif
 [05]: media/aishell-powershell/start-aishell.gif
 [06]: media/aishell-powershell/switch-agents.gif
+
diff --git a/reference/docs-conceptual/AIShell/get-started/aishell-standalone.md b/reference/docs-conceptual/AIShell/get-started/aishell-standalone.md
@@ -1,8 +1,9 @@
 ---
 description: This article explains how to install and configure AI Shell, and get started chatting with an AI assistant.
-ms.date: 10/29/2024
+ms.date: 01/12/2026
 title: Get started with AI Shell
 ms.topic: get-started
+ms.collection: ce-skilling-ai-copilot
 ---
 # Get started with AI Shell
 
@@ -94,3 +95,4 @@ custom key bindings will be supported in a future release.
 <!-- link references -->
 [01]: aishell-powershell.md
 [02]: media/aishell-standalone/standalone-startup.gif
+
diff --git a/reference/docs-conceptual/AIShell/how-to/agent-azure.md b/reference/docs-conceptual/AIShell/how-to/agent-azure.md
@@ -1,7 +1,8 @@
 ---
 title: Azure Copilot Agent
 description: Learn how to use the Azure Copilot agent in AI Shell.
-ms.date: 08/25/2025
+ms.date: 01/12/2026
+ms.collection: ce-skilling-ai-copilot
 ---
 # Azure Copilot Agent
 
@@ -68,3 +69,4 @@ To disable telemetry, set the **telemetry** property to `false`.
 <!-- link references -->
 [01]: /cli/azure/install-azure-cli
 [02]: https://azure.microsoft.com/products/copilot
+
diff --git a/reference/docs-conceptual/AIShell/how-to/agent-openai.md b/reference/docs-conceptual/AIShell/how-to/agent-openai.md
@@ -1,8 +1,9 @@
 ---
 title: OpenAI agent
 description: Learn how to configure the OpenAI agent.
-ms.date: 09/09/2025
+ms.date: 01/12/2026
 ms.topic: how-to
+ms.collection: ce-skilling-ai-copilot
 ---
 # OpenAI agent
 
@@ -229,3 +230,4 @@ Next, add a new GPT to your `openai.agent.json` file.
 [07]: https://localai.io/
 [08]: https://ollama.com/blog/openai-compatibility
 [09]: xref:Azure.Identity.DefaultAzureCredential
+
diff --git a/reference/docs-conceptual/AIShell/how-to/aishell-reference.md b/reference/docs-conceptual/AIShell/how-to/aishell-reference.md
@@ -1,8 +1,9 @@
 ---
 title: AI Shell command reference
 description: Learn about the command-line options and commands available in AI Shell.
-ms.date: 09/09/2025
+ms.date: 01/12/2026
 ms.topic: reference
+ms.collection: ce-skilling-ai-copilot
 ---
 # AI Shell command reference
 
@@ -427,3 +428,4 @@ files:
 [01]: media/aishell-reference/code-copy-command.gif
 [02]: media/aishell-reference/code-post-command.gif
 [03]: media/aishell-reference/code-save-command.png
+
diff --git a/reference/docs-conceptual/AIShell/how-to/mcp-support.md b/reference/docs-conceptual/AIShell/how-to/mcp-support.md
@@ -1,8 +1,9 @@
 ---
 title: MCP support
 description: Learn how to enable and use MCPs in AIShell.
-ms.date: 08/25/2025
+ms.date: 01/12/2026
 ms.topic: how-to
+ms.collection: ce-skilling-ai-copilot
 ---
 # MCP support
 
@@ -159,3 +160,4 @@ For more information about the remote MCP server from Microsoft, see:
 [07]: media/mcp-support/openai-agent-context.gif
 [08]: media/mcp-support/openai-agent-get.gif
 [09]: media/mcp-support/openai-agent-run.gif
+
diff --git a/reference/docs-conceptual/AIShell/install-aishell.md b/reference/docs-conceptual/AIShell/install-aishell.md
@@ -1,8 +1,9 @@
 ---
 title: Install AI Shell
 description: Learn how to install AI Shell on your system.
-ms.date: 09/09/2025
+ms.date: 01/12/2026
 ms.topic: install-set-up-deploy
+ms.collection: ce-skilling-ai-copilot
 ---
 # Install AI Shell
 
@@ -125,3 +126,4 @@ To manually install AI Shell, follow the instructions for your platform:
 [01]: get-started/aishell-powershell.md
 [02]: get-started/aishell-standalone.md
 [03]: https://github.com/PowerShell/AIShell/releases/latest
+
diff --git a/reference/docs-conceptual/AIShell/overview.md b/reference/docs-conceptual/AIShell/overview.md
@@ -1,10 +1,10 @@
 ---
 title: What is AI Shell?
 description: Learn about AI Shell, an interactive shell that provides a chat interface with language models.
-ms.date: 09/09/2025
+ms.date: 01/12/2026
 ms.topic: overview
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # What is AI Shell?
 
 AI Shell is an interactive shell that provides a chat interface with language models. The shell
@@ -80,3 +80,4 @@ Here are ways you can get involved:
 [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
@@ -1,10 +1,10 @@
 ---
 title: AI Shell release notes
 description: >
-  Find out what's new in the latest release of AI Shell, an interactive shell that provides a chat
-  interface with language models.
-ms.date: 09/09/2025
+  Find out what's new in the latest release of AI Shell, an interactive shell that provides a chat interface with language models.
+ms.date: 01/12/2026
 ms.topic: overview
+ms.collection: ce-skilling-ai-copilot
 ---
 # AI Shell Release Notes
 
@@ -123,3 +123,4 @@ includes two agents by default:
 [07]: https://github.com/PowerShell/AIShell/releases/tag/v1.0.0-preview.3
 [08]: https://github.com/PowerShell/AIShell/releases/tag/v1.0.0-preview.5
 [362]: https://github.com/dotnet/announcements/issues/362
+
diff --git a/reference/ps-modules/AIShell/AIShell.md b/reference/ps-modules/AIShell/AIShell.md
@@ -4,11 +4,11 @@ Help Version: 1.0.0
 Locale: en-US
 Module Guid: ecb8bee0-59b9-4dae-9d7b-a990b480279a
 Module Name: AIShell
-ms.date: 08/27/2025
+ms.date: 01/12/2026
 ms.custom: 1.0.0-preview.6
 title: AIShell Module
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # AIShell Module
 
 ## Description
@@ -34,3 +34,4 @@ Sends the last error in the current session  for resolution in the connected AIS
 
 Starts an AIShell session in a split pane window of Windows Terminal and iTerm2 and connects a
 communication channel to the PowerShell session that started it.
+
diff --git a/reference/ps-modules/AIShell/Invoke-AICommand.md b/reference/ps-modules/AIShell/Invoke-AICommand.md
@@ -1,12 +1,12 @@
-﻿---
+---
 external help file: AIShell.Integration.dll-Help.xml
 Module Name: AIShell
 ms.custom: 1.0.0-preview.6
-ms.date: 08/25/2025
+ms.date: 01/12/2026
 online version: https://learn.microsoft.com/en-us/powershell/module/aishell/invoke-aicommand?view=ps-modules&wt.mc_id=ps-gethelp
 schema: 2.0.0
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # Invoke-AICommand
 
 ## SYNOPSIS
@@ -63,3 +63,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 
 ## RELATED LINKS
+
diff --git a/reference/ps-modules/AIShell/Invoke-AIShell.md b/reference/ps-modules/AIShell/Invoke-AIShell.md
@@ -2,11 +2,11 @@
 external help file: AIShell.Integration.dll-Help.xml
 Module Name: AIShell
 online version: https://learn.microsoft.com/en-us/powershell/module/aishell/invoke-aishell?view=ps-modules&wt.mc_id=ps-gethelp
-ms.date: 05/16/2025
+ms.date: 01/12/2026
 ms.custom: 1.0.0-preview.6
 schema: 2.0.0
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # Invoke-AIShell
 
 ## SYNOPSIS
@@ -205,3 +205,4 @@ PowerShell includes the following alias for this cmdlet:
 [Start-AIShell](Start-AIShell.md)
 
 [Resolve-Error](Resolve-Error.md)
+
diff --git a/reference/ps-modules/AIShell/Resolve-Error.md b/reference/ps-modules/AIShell/Resolve-Error.md
@@ -2,11 +2,11 @@
 external help file: AIShell.Integration.dll-Help.xml
 Module Name: AIShell
 online version: https://learn.microsoft.com/en-us/powershell/module/aishell/resolve-error?view=ps-modules&wt.mc_id=ps-gethelp
-ms.date: 05/16/2025
+ms.date: 01/12/2026
 ms.custom: 1.0.0-preview.6
 schema: 2.0.0
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # Resolve-Error
 
 ## SYNOPSIS
@@ -104,3 +104,4 @@ PowerShell includes the following alias for this cmdlet:
 [Invoke-AIShell](Invoke-AIShell.md)
 
 [Start-AIShell](Start-AIShell.md)
+
diff --git a/reference/ps-modules/AIShell/Start-AIShell.md b/reference/ps-modules/AIShell/Start-AIShell.md
@@ -2,11 +2,11 @@
 external help file: AIShell.Integration.dll-Help.xml
 Module Name: AIShell
 online version: https://learn.microsoft.com/en-us/powershell/module/aishell/start-aishell?view=ps-modules&wt.mc_id=ps-gethelp
-ms.date: 05/16/2025
+ms.date: 01/12/2026
 ms.custom: 1.0.0-preview.6
 schema: 2.0.0
+ms.collection: ce-skilling-ai-copilot
 ---
-
 # Start-AIShell
 
 ## SYNOPSIS
@@ -90,3 +90,4 @@ PowerShell includes the following alias for this cmdlet:
 [Invoke-AIShell](Invoke-AIShell.md)
 
 [Resolve-Error](Resolve-Error.md)
+
diff --git a/reference/ps-modules/Microsoft.PowerShell.Crescendo/.vscode/settings.json b/reference/ps-modules/Microsoft.PowerShell.Crescendo/.vscode/settings.json
@@ -0,0 +1,8 @@
+{
+    "markdownlint.config": {
+        "MD028": false,
+        "MD025": {
+            "front_matter_title": ""
+        }
+    }
+}
