GitHub Copilot Agent

The Packfiles GitHub Copilot Agent is an AI agent built into the Packfiles Warp app that helps you plan, execute, and troubleshoot migrations without leaving GitHub.

Instead of consulting documentation, manually reviewing repository inventories, or reading runner logs to decode a failure, you can work directly with the agent in the places where migration work already happens: the Migration HQ Agents tab, a backlog issue, or a pull request.

Prerequisites

Before using the Packfiles GitHub Copilot Agent, ensure that:

• Your Migration HQ repository has been initialized by Warp and a source scan has completed successfully, so that backlog issues have been created for your repositories

• GitHub Copilot is enabled for your organization

• Packfiles Warp App is installed on your Migration HQ organization

• You complete the setup steps outlined below to give the agent the necessary permissions to operate in your Migration HQ repository

Setup

To configure the agent for your Migration HQ repository:

1. Add the following GitHub MCP configuration under Migration-HQ → Settings → Code & automation → Copilot → Coding agent:

   Copy

   {
   	"mcpServers": {
   			"github-mcp-server": {
   			"type": "http",
   			"url": "https://api.githubcopilot.com/mcp",
   			"tools": ["*"],
   			"headers": {
   				"X-MCP-Toolsets": "issues,pull_requests,repos,actions"
   			}
   		}
   	}
   }

   Ensure you've saved the configuration before proceeding to the next step.

2. Create a fine-grained PAT with:

   • Issues: read+write

   • Pull requests: read+write

   on the Migration-HQ repository only.

3. Add the PAT as a secret named COPILOT_MCP_GITHUB_PERSONAL_ACCESS_TOKEN in the Migration-HQ repository under Settings → Secrets and variables → Agents.

4. Follow the instructions in the GitHub documentation to enable agent apps at the Enterprise level.

This setup allows the agent to make diagnostic comments on backlog issues and pull requests, and to create new wave labels for migration planning. For more information on the agent's capabilities and how to invoke them, see the next section.

What the Agent Can Do

The Packfiles GitHub Copilot Agent has three capabilities, each invoked from a different entry point in Migration HQ:

The agent supports both Azure DevOps and Bitbucket Server migrations, including projects with a mix of both sources.

Further Reading

• Migration Planning — Plan your migration waves and generate a strategy document

• Migration Diagnosis — Diagnose and fix failed migrations

• Validate Configuration — Validate and author config/warp.yml changes