Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions .vscode/extensions.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
8 changes: 8 additions & 0 deletions reference/.vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"markdownlint.config": {
"MD028": false,
"MD025": {
"front_matter_title": ""
}
}
}
Original file line number Diff line number Diff line change
@@ -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?

Expand Down Expand Up @@ -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/

Original file line number Diff line number Diff line change
@@ -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]
Expand Down Expand Up @@ -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

Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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

Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

4 changes: 3 additions & 1 deletion reference/docs-conceptual/AIShell/how-to/agent-azure.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

4 changes: 3 additions & 1 deletion reference/docs-conceptual/AIShell/how-to/agent-openai.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

4 changes: 3 additions & 1 deletion reference/docs-conceptual/AIShell/how-to/mcp-support.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

4 changes: 3 additions & 1 deletion reference/docs-conceptual/AIShell/install-aishell.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

5 changes: 3 additions & 2 deletions reference/docs-conceptual/AIShell/overview.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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

7 changes: 4 additions & 3 deletions reference/docs-conceptual/AIShell/release-notes.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

5 changes: 3 additions & 2 deletions reference/ps-modules/AIShell/AIShell.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.

7 changes: 4 additions & 3 deletions reference/ps-modules/AIShell/Invoke-AICommand.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -63,3 +63,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## NOTES

## RELATED LINKS

5 changes: 3 additions & 2 deletions reference/ps-modules/AIShell/Invoke-AIShell.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -205,3 +205,4 @@ PowerShell includes the following alias for this cmdlet:
[Start-AIShell](Start-AIShell.md)

[Resolve-Error](Resolve-Error.md)

5 changes: 3 additions & 2 deletions reference/ps-modules/AIShell/Resolve-Error.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -104,3 +104,4 @@ PowerShell includes the following alias for this cmdlet:
[Invoke-AIShell](Invoke-AIShell.md)

[Start-AIShell](Start-AIShell.md)

5 changes: 3 additions & 2 deletions reference/ps-modules/AIShell/Start-AIShell.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -90,3 +90,4 @@ PowerShell includes the following alias for this cmdlet:
[Invoke-AIShell](Invoke-AIShell.md)

[Resolve-Error](Resolve-Error.md)

Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"markdownlint.config": {
"MD028": false,
"MD025": {
"front_matter_title": ""
}
}
}