|
| 1 | +--- |
| 2 | +title: Rolling out the GitHub Copilot app to your team |
| 3 | +shortTitle: Roll out the Copilot app |
| 4 | +intro: Roll out the GitHub Copilot app so developers can direct agents across parallel tasks while you control access, model availability, and external tools. |
| 5 | +allowTitleToDifferFromFilename: true |
| 6 | +versions: |
| 7 | + feature: copilot |
| 8 | +contentType: tutorials |
| 9 | +category: |
| 10 | + - Roll Copilot out at scale |
| 11 | + - Manage Copilot for a team |
| 12 | +--- |
| 13 | + |
| 14 | +The {% data variables.copilot.github_copilot_app %} is a desktop application for directing agents, reviewing changes, and managing pull requests across parallel workstreams. |
| 15 | + |
| 16 | +Each developer installs the app and signs in individually. You govern their access through {% data variables.product.prodname_copilot_short %} licenses and enterprise or organization policies. |
| 17 | + |
| 18 | +Use this tutorial to configure a pilot, guide developers through their first task, and validate the app workflow before a wider rollout. |
| 19 | + |
| 20 | +## Prerequisites |
| 21 | + |
| 22 | +Before you start: |
| 23 | + |
| 24 | +* Make sure each pilot developer has a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} license from the enterprise or organization that will govern their access. |
| 25 | +* Choose a pilot repository where developers can make changes and open pull requests. |
| 26 | +* Create a well-scoped issue for a small, low-risk task, such as adding tests for existing behavior. |
| 27 | + |
| 28 | +For information about how licenses and policies interact, see [AUTOTITLE](/copilot/concepts/enterprise/policies). |
| 29 | + |
| 30 | +## 1. Configure access and policies |
| 31 | + |
| 32 | +If your organizations belong to an enterprise, first establish enterprise-level baselines for policies and model availability. Then configure each organization. Enterprise policies can enforce a setting or, for most policies, allow organizations to decide. |
| 33 | + |
| 34 | +1. Confirm that the **{% data variables.copilot.github_copilot_app %}** policy is enabled for the enterprise or organization that supplies licenses to the pilot developers. |
| 35 | + |
| 36 | + The policy is enabled by default for {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %}. It is independent from the {% data variables.copilot.copilot_cli_short %} policy, so enabling one does not enable the other. |
| 37 | + |
| 38 | + For instructions, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies) or [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies). |
| 39 | + |
| 40 | +1. Configure the models that pilot developers can use. |
| 41 | + |
| 42 | + Model availability policies apply to the {% data variables.copilot.github_copilot_app %}. Establish a baseline that meets your security, compliance, and cost requirements before the pilot begins. |
| 43 | + |
| 44 | + For instructions, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-availability-of-default-models) or [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-default-models). |
| 45 | + |
| 46 | +1. If pilot developers need Model Context Protocol (MCP) servers, identify the servers required for the pilot and enable the **MCP servers in {% data variables.product.prodname_copilot_short %}** policy. |
| 47 | + |
| 48 | + In your enterprise's `{% data variables.copilot.managed_setting_file %}` file, use `allowedMcpServers` to permit only the approved servers. If necessary, use `deniedMcpServers` to block specific server configurations. These settings control which servers can run, but do not install the servers for developers. |
| 49 | + |
| 50 | + For instructions, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-enterprise-allowlist). |
| 51 | + |
| 52 | +## 2. Ask developers to install and sign in |
| 53 | + |
| 54 | +After you configure access and policies, ask each developer to: |
| 55 | + |
| 56 | +1. Visit the [download page for the {% data variables.copilot.github_copilot_app %}](https://github.com/features/ai/github-app). |
| 57 | +1. Download and install the app for their operating system. |
| 58 | +1. Open the app. |
| 59 | +1. Click **Sign in to {% data variables.product.github %}** and follow the prompts to authenticate. |
| 60 | +1. Select the pilot repository when prompted. Participants can also add an existing local repository or clone the repository later. |
| 61 | +1. If the pilot task requires an MCP server, in the app sidebar, click **Customize**, then **MCP**. Install an approved server required for the task. |
| 62 | + |
| 63 | +For the complete app setup procedure, see [AUTOTITLE](/copilot/get-started/quickstart-copilot-app). For more information about installing MCP servers, see [AUTOTITLE](/copilot/how-tos/github-copilot-app/customize-github-copilot-app#configuring-mcp-servers). |
| 64 | + |
| 65 | +## 3. Complete a first useful task |
| 66 | + |
| 67 | +Start with a task that demonstrates repository context, code changes, test execution, and human review without changing production behavior. |
| 68 | + |
| 69 | +Ask each developer to: |
| 70 | + |
| 71 | +1. In the sidebar, open **My work**. |
| 72 | +1. Find and open the issue for the pilot task. |
| 73 | +1. Click **New session**. The app creates a session with the issue context already loaded. |
| 74 | +1. Select **Interactive** mode and an approved model. |
| 75 | +1. In the prompt box, paste the following prompt: |
| 76 | + |
| 77 | + ```copilot copy |
| 78 | + Implement this issue without changing unrelated behavior. |
| 79 | + Run the relevant tests, then summarize the diff and results. |
| 80 | + ``` |
| 81 | + |
| 82 | +1. Respond to requests for input from the agent. |
| 83 | +1. After the agent makes changes, click **Changes** and review the diff. |
| 84 | +1. Ask the agent to correct any problems. |
| 85 | +1. To keep the changes, click **Create PR** and follow your normal review process. |
| 86 | + |
| 87 | +This task validates that each developer can access the repository, use an approved model and, if applicable, an approved MCP server, run project tools, and review agent-generated changes. |
| 88 | + |
| 89 | +For more information about starting sessions from issues, see [AUTOTITLE](/copilot/how-tos/github-copilot-app/managing-issues-and-pull-requests). |
| 90 | + |
| 91 | +## 4. Run independent workstreams in parallel |
| 92 | + |
| 93 | +Sessions that run in new working trees use isolated workspaces. Developers can make progress on independent tasks without one session changing another session's working files. |
| 94 | + |
| 95 | +Ask developers to try this workflow: |
| 96 | + |
| 97 | +1. Keep the first session open. |
| 98 | +1. Click **+** next to **Sessions** and start another session in the same repository. |
| 99 | +1. Choose to run the session in a new working tree. |
| 100 | +1. Give the second session an independent task. |
| 101 | +1. Switch between sessions in the sidebar to monitor progress and provide feedback. |
| 102 | +1. Review each session independently and create separate pull requests for any changes you want to keep. |
| 103 | + |
| 104 | +For more information about isolated workspaces, session modes, and model selection, see [AUTOTITLE](/copilot/how-tos/github-copilot-app/agent-sessions). |
| 105 | + |
| 106 | +After developers complete the pilot, gather feedback about installation, policy restrictions, task selection, and review quality. Use their feedback to resolve common barriers and improve your internal guidance before rolling out the app more widely. |
0 commit comments