← Back
GitHub
GitHub Copilot coding agent now supports Windows development environments

Windows Environment Support

GitHub Copilot's autonomous coding agent—which delegates tasks to run asynchronously in the background—previously defaulted to Linux environments. Developers targeting Windows projects can now configure the agent to use a Windows development environment instead, maintaining the same GitHub Actions-powered execution model.

Configuration and Setup

To enable Windows support, create a copilot-setup-steps.yml file in your repository and specify a custom runs-on setting to direct the agent to use Windows runners. This allows the agent to execute in an environment that matches your project's actual deployment target.

Build Verification and Quality Gates

With a properly configured Windows development environment, Copilot can ensure that:

  • Your project builds successfully
  • Automated tests pass
  • Linter checks complete without errors

This reduces the likelihood of failed or problematic pull requests, letting you merge with confidence on the first attempt.

Important Limitations and Recommendations

The integrated firewall feature that Copilot includes is not compatible with Windows environments. GitHub recommends using Windows configurations only with:

  • Self-hosted runners
  • Larger runners with Azure private networking where you can implement custom network controls

For implementation details, see the GitHub Docs section on "Customizing the development environment for Copilot coding agent".