You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: hub/apps/get-started/ai-setup.md
+17-14Lines changed: 17 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,10 @@ ms.localizationpriority: medium
11
11
12
12
# Set up GitHub Copilot for Windows development
13
13
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.
15
18
16
19
## Prerequisites
17
20
@@ -23,25 +26,25 @@ This guide walks you through setting up GitHub Copilot with the tools that make
23
26
24
27
## Step 1: Install GitHub Copilot in your IDE
25
28
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)
34
30
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.
38
32
39
33
1. Open Visual Studio and go to **Extensions** > **Manage Extensions**.
40
34
2. Search for **GitHub Copilot** and install it, or verify it's already installed.
41
35
3. Sign in via **Tools** > **Options** > **GitHub** > **Accounts**.
42
36
43
37
For detailed setup, see [GitHub Copilot in Visual Studio](../how-tos/github-copilot-winui-vs.md).
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
+
45
48
---
46
49
47
50
## 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:
107
110
Open Copilot Chat and try these prompts to confirm everything is working:
108
111
109
112
**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."*
111
114
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.
113
116
114
117
**Test the Learn MCP Server:**
115
118
> *"Look up the latest Windows App SDK release notes and tell me what's new."*
0 commit comments