Skip to content

Commit 3ede27e

Browse files
authored
Merge pull request #8706 from galiacheng/haiche/modernize-quickstart
Update quickstart guide for Copilot modernization agent installation
2 parents 8911fc5 + 5840e09 commit 3ede27e

1 file changed

Lines changed: 31 additions & 6 deletions

File tree

  • articles/github-copilot-app-modernization/modernization-agent

articles/github-copilot-app-modernization/modernization-agent/quickstart.md

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: karler
66
ms.reviewer: jessiehuang
77
ms.topic: quickstart
88
ai-usage: ai-assisted
9-
ms.date: 03/11/2026
9+
ms.date: 03/13/2026
1010
---
1111

1212
# Quickstart: Install and use the GitHub Copilot modernization agent
@@ -16,7 +16,7 @@ This quickstart guides you through installing the GitHub Copilot modernization a
1616
## Prerequisites
1717

1818
- **A GitHub Copilot subscription**: Free, Pro, Pro+, Business, or Enterprise plan. See [Copilot plans](https://github.com/features/copilot/plans).
19-
- **GitHub CLI**: Install the GitHub CLI (`gh`) for authentication. See [Installing gh](https://cli.github.com/).
19+
- **GitHub CLI**: Install the GitHub CLI (`gh`) for authentication, `v2.45.0` or above. See [Installing gh](https://cli.github.com/).
2020

2121
### Platform requirements
2222

@@ -30,20 +30,45 @@ Use the following commands to install the modernization agent or update to the l
3030

3131
### [Windows](#tab/windows)
3232

33-
Run the following command in PowerShell:
33+
Use one of the following options:
34+
35+
**Option 1 - Winget (recommended):**
36+
37+
```powershell
38+
winget install GitHub.Copilot.modernization.agent
39+
```
40+
41+
For silent installation with no prompts:
42+
43+
```powershell
44+
winget install GitHub.Copilot.modernization.agent --silent
45+
```
46+
47+
**Option 2 - PowerShell one-liner:**
3448

3549
```powershell
3650
iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')
3751
```
3852

39-
Alternatively, download and run the MSI installer from the [GitHub releases page](https://github.com/microsoft/modernize-cli/releases).
53+
**Option 3 - MSI installer:**
54+
55+
Download and run the latest MSI from the [GitHub releases page](https://github.com/microsoft/modernize-cli/releases/latest).
4056

4157
> [!NOTE]
42-
> These commands work for both initial installation and updating to the latest version. A dedicated version update command will be available in a future release.
58+
> After installation, open a new terminal for the `modernize` command to be available on your PATH. These commands work for both initial installation and updating to the latest version. A dedicated version update command will be available in a future release.
4359
4460
### [Linux/macOS](#tab/linux-macos)
4561

46-
Run the following command:
62+
Use one of the following options:
63+
64+
**Option 1 - Homebrew:**
65+
66+
```bash
67+
brew tap microsoft/modernize https://github.com/microsoft/modernize-cli
68+
brew install modernize
69+
```
70+
71+
**Option 2 - Shell script:**
4772

4873
```bash
4974
curl -fsSL https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.sh | bash

0 commit comments

Comments
 (0)