diff --git a/.vscode/extensions.json b/.vscode/extensions.json index 066d9a1..3a67d26 100644 --- 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 new file mode 100644 index 0000000..ed9462b --- /dev/null +++ b/reference/.vscode/settings.json @@ -0,0 +1,8 @@ +{ + "markdownlint.config": { + "MD028": false, + "MD025": { + "front_matter_title": "" + } + } +} \ No newline at end of file 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 35a1da4..d1558be 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 @@ -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 index 8d16ef2..79af59c 100644 --- 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 [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 index d4ed791..d7505d3 100644 --- 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 index ec979df..2e3e3c9 100644 --- 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 index f988503..fcd2e96 100644 --- 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 \ No newline at end of file +[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 index ebd22d6..731297b 100644 --- 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 index 9aa53c2..855ffd0 100644 --- 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. [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 index 9853438..83baec3 100644 --- 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`. [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 index 4422d78..f812dda 100644 --- 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 index 67a8b90..36c1a3c 100644 --- 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 index 57a9a14..79e0241 100644 --- 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 index 860d96f..ddd3b95 100644 --- 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 index f3f444c..1851785 100644 --- 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 index d70ac35..d89b7c8 100644 --- 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 index c282573..ca69d72 100644 --- 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 index 998bd98..5cdd319 100644 --- 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 index e2c393f..cc96593 100644 --- 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 index 15dd92b..61304da 100644 --- 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 index b5cf5a3..08f4f72 100644 --- 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 new file mode 100644 index 0000000..ed9462b --- /dev/null +++ b/reference/ps-modules/Microsoft.PowerShell.Crescendo/.vscode/settings.json @@ -0,0 +1,8 @@ +{ + "markdownlint.config": { + "MD028": false, + "MD025": { + "front_matter_title": "" + } + } +} \ No newline at end of file