# upgrade-agent

This plugin adds an agent for assessing, planning, and applying application upgrades, including .NET migrations and legacy-code modernization.

- plugin · `type=plugin` · GitHub Copilot · ★ 43
- Author: Microsoft
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/microsoft/upgrade-agent-plugins/tree/HEAD/plugins/upgrade-agent
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/plugins/upgrade-agent

## What it does

The plugin adds the `upgrade` agent to GitHub Copilot. It examines an application, identifies migration work, and helps move legacy code toward current frameworks, including newer .NET versions.

Its workflow has three stages. Assessment inspects the project, planning turns the findings into ordered tasks, and execution applies changes with dedicated tools. The package also contains an Upgrade MCP server that supplies analysis and upgrade capabilities.

The MCP server starts when the agent is invoked, so there is no separate setup step for it. The upgrade flow only starts after you select `upgrade` with `/agent`.

## Install

### GitHub Copilot (native platform)

**Command from the source**
```bash
copilot plugin install upgrade-agent@awesome-copilot
```

## When to use it
- assess a project before migration
- create a step-by-step upgrade plan
- move an application to a current .NET framework
- modernize legacy application code
- apply planned upgrade changes

## Example prompts
- Use `/agent` to select `upgrade`, then ask it to move the project to .NET 10.
- Select `upgrade` with `/agent` and have it assess the project before migration.
- Choose `upgrade` through `/agent` and ask it to carry out the proposed application changes.

## Similar
- [modernize-dotnet](https://affpapa.org/en/nevibecode/plugins/modernize-dotnet.md) — plugin · ★ 1205
- [dotnet-upgrade](https://affpapa.org/en/nevibecode/skills/dotnet-upgrade.md) — skill · 11475 installs
- [.NET Upgrade](https://affpapa.org/en/nevibecode/agents/net-upgrade.md) — subagent · ★ 40451
- [github-copilot-modernization](https://affpapa.org/en/nevibecode/plugins/github-copilot-modernization.md) — plugin · ★ 54
- [remotion-upgrade](https://affpapa.org/en/nevibecode/skills/remotion-dev-remotion-upgrade.md) — skill · 191900 installs
- [om-apply-upgrade-notes](https://affpapa.org/en/nevibecode/skills/om-apply-upgrade-notes.md) — skill · 3700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md