Skip to content

Commit b811d04

Browse files
Fix ai-setup.md: VS Code scope, verification test framing
- Clarify VS Code is for non-WinUI frameworks (Electron, Flutter, .NET, Rust); Visual Studio is required for WinUI 3 build/debug - Fix verification prompt: use a positive task ('add a confirmation dialog') instead of 'Don't use MessageDialog' which implies the plugin doesn't actually fix the problem - Add intro note about VS requirement upfront Co-authored-by: Copilot <[email protected]>
1 parent cf2d391 commit b811d04

1 file changed

Lines changed: 17 additions & 14 deletions

File tree

hub/apps/get-started/ai-setup.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,10 @@ ms.localizationpriority: medium
1111

1212
# Set up GitHub Copilot for Windows development
1313

14-
This guide walks you through setting up GitHub Copilot with the tools that make it genuinely useful for Windows development: the **WinUI 3 development plugin** that keeps Copilot on modern APIs, and the **Microsoft Learn MCP Server** that gives Copilot live access to official Windows documentation.
14+
This guide walks you through setting up GitHub Copilot with the tools that make it genuinely useful for Windows development: the **WinUI 3 development plugin** that gives Copilot accurate Windows App SDK context, and the **Microsoft Learn MCP Server** that gives Copilot live access to official Windows documentation.
15+
16+
> [!NOTE]
17+
> Building and debugging WinUI 3 apps requires **Visual Studio** — VS Code doesn't have MSIX build tooling or WinUI project templates. If you're working on other Windows frameworks (Electron, Flutter, .NET, or Rust via winapp CLI), VS Code works well for those. Steps below are marked accordingly.
1518
1619
## Prerequisites
1720

@@ -23,25 +26,25 @@ This guide walks you through setting up GitHub Copilot with the tools that make
2326

2427
## Step 1: Install GitHub Copilot in your IDE
2528

26-
#### [VS Code](#tab/vscode)
27-
28-
1. Open VS Code and go to the **Extensions** view (`Ctrl+Shift+X`).
29-
2. Search for **GitHub Copilot** and install the extension.
30-
3. Sign in with your GitHub account when prompted.
31-
4. To enable **agent mode** (required for multi-step tasks), open **Settings** (`Ctrl+,`), search for `chat.agent.enabled`, and toggle it on.
32-
33-
For detailed setup, see [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/overview).
29+
#### [Visual Studio (WinUI 3)](#tab/visualstudio)
3430

35-
#### [Visual Studio](#tab/visualstudio)
36-
37-
GitHub Copilot is built into Visual Studio 2022 17.10 and later.
31+
GitHub Copilot is built into Visual Studio 2022 17.10 and later. Visual Studio is required for WinUI 3 development.
3832

3933
1. Open Visual Studio and go to **Extensions** > **Manage Extensions**.
4034
2. Search for **GitHub Copilot** and install it, or verify it's already installed.
4135
3. Sign in via **Tools** > **Options** > **GitHub** > **Accounts**.
4236

4337
For detailed setup, see [GitHub Copilot in Visual Studio](../how-tos/github-copilot-winui-vs.md).
4438

39+
#### [VS Code (Electron, Flutter, .NET, Rust)](#tab/vscode)
40+
41+
1. Open VS Code and go to the **Extensions** view (`Ctrl+Shift+X`).
42+
2. Search for **GitHub Copilot** and install the extension.
43+
3. Sign in with your GitHub account when prompted.
44+
4. To enable **agent mode** (required for multi-step tasks), open **Settings** (`Ctrl+,`), search for `chat.agent.enabled`, and toggle it on.
45+
46+
For detailed setup, see [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/overview).
47+
4548
---
4649

4750
## Step 2: Install the WinUI 3 development plugin
@@ -107,9 +110,9 @@ Or, to add it per-project, create `.vscode/mcp.json` in your project root:
107110
Open Copilot Chat and try these prompts to confirm everything is working:
108111

109112
**Test the WinUI 3 plugin:**
110-
> *"What's the correct WinUI 3 API for showing a modal dialog? Don't use MessageDialog."*
113+
> *"Add a confirmation dialog to my WinUI 3 app that asks before deleting an item."*
111114
112-
Copilot should give you `ContentDialog` with the correct `XamlRoot` setup — not the deprecated UWP `MessageDialog`.
115+
Copilot should respond with a `ContentDialog` implementation including the required `XamlRoot` setup — the plugin's Windows App SDK context guides it to the right modern API without you needing to specify what to avoid.
113116

114117
**Test the Learn MCP Server:**
115118
> *"Look up the latest Windows App SDK release notes and tell me what's new."*

0 commit comments

Comments
 (0)