{"meta":{"title":"Asking GitHub Copilot to create a pull request","intro":"You can ask Copilot to create a pull request from many places, including GitHub Issues, the agents panel, Copilot Chat, the GitHub CLI, and agentic coding tools and IDEs with Model Context Protocol (MCP) support.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/use-copilot-agents","title":"Use Copilot agents"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent","title":"Cloud agent"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr","title":"Create a PR"}],"documentType":"article"},"body":"# Asking GitHub Copilot to create a pull request\n\nYou can ask Copilot to create a pull request from many places, including GitHub Issues, the agents panel, Copilot Chat, the GitHub CLI, and agentic coding tools and IDEs with Model Context Protocol (MCP) support.\n\n> \\[!NOTE]\n> For an overview of Copilot cloud agent, see [About GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/about-cloud-agent).\n\n## Introduction\n\nYou can ask Copilot to create a new pull request from:\n\n* GitHub Issues, by [assigning an issue to Copilot](#assigning-an-issue-to-copilot)\n* The [agents tab or panel](#asking-copilot-to-create-a-pull-request-from-the-agents-tab-or-panel) on GitHub\n* The [dashboard](#asking-copilot-to-create-a-pull-request-from-the-dashboard) on GitHub\n* Copilot Chat in [Visual Studio Code](#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-visual-studio-code), [JetBrains IDEs](#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-jetbrains-ides), [Eclipse](#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-eclipse) and [Visual Studio 2026](#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-visual-studio-2026)\n* Copilot Chat on [GitHub.com](#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-githubcom)\n* The [GitHub CLI](#asking-copilot-to-create-a-pull-request-from-the-github-cli)\n* On [GitHub Mobile](#asking-copilot-to-create-a-pull-request-from-github-mobile)\n* Your preferred IDE or agentic coding tool with [Model Context Protocol (MCP)](#asking-copilot-to-create-a-pull-request-from-the-github-mcp-server) support\n* The [Raycast](#asking-copilot-to-create-a-pull-request-from-raycast) launcher\n* The [\"New repository\" form](#asking-copilot-to-create-a-pull-request-from-the-new-repository-page) on GitHub\n\nCopilot will start working on the task, raise a pull request, then request a review from you when it's finished working. For more information, see [About GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/about-cloud-agent).\n\n## Assigning an issue to Copilot\n\nYou can ask Copilot to start working on an issue by assigning the issue to Copilot.\n\nYou can assign an issue to Copilot:\n\n* On GitHub.com (see the [next section](#assigning-an-issue-to-copilot-on-githubcom))\n* On [GitHub Mobile](#assigning-an-issue-to-copilot-on-github-mobile)\n* Via the GitHub API (see [later in this article](#assigning-an-issue-to-copilot-via-the-github-api))\n* Using the [Raycast launcher](#assigning-an-issue-to-copilot-from-raycast)\n* Using GitHub CLI (see [`gh issue edit`](https://cli.github.com/manual/gh_issue_edit))\n\n### Assigning an issue to Copilot on GitHub.com\n\n> \\[!NOTE]\n> This feature is in public preview and subject to change.\n\n1. On GitHub, navigate to the main page of the repository.\n\n2. Under your repository name, click ** Issues**.\n\n \n\n3. Open the issue that you want to assign to Copilot.\n\n4. In the right side menu, click **Assignees**.\n\n \n\n5. Click **Copilot** from assignees list.\n\n \n\n Additional options are displayed.\n\n \n\n6. In the **Optional prompt** field you can add specific guidance for Copilot. Add any context, constraints, or specific requirements that will help Copilot to understand and complete the task.\n\n For example, you might include instructions about specific coding patterns or frameworks to use, testing requirements, code style preferences, files or directories that should or shouldn't be modified.\n\n In addition to the details you supply here, Copilot will use any custom instructions that have been configured for the target repository. See [Adding repository custom instructions for GitHub Copilot](/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions).\n\n7. You can use the dropdown menus in the dialog to change the repository that Copilot will work in and the branch that it will branch off from.\n\n All repositories where you have **at least** read access will be displayed in the repository dropdown menu. However, you can only select a repository if you have write access to it, **and** if Copilot cloud agent is enabled for that repository.\n\n If you select a repository in a different organization than the issue's source organization, or if you select a public repository when the issue is in a private repository, a warning will be displayed.\n\n If you don't specify a repository, Copilot will work in the same repository as the issue. If you don't specify a branch, Copilot will work from the default branch of the selected repository.\n\n > \\[!TIP]\n > When you assign an issue to Copilot, it gets sent the issue title, description, any comments that currently exist, and any additional instructions you provide. After assigning the issue, Copilot will not be aware of, and therefore won't react to, any further comments that are added to the issue. If you have more information, or changes to the original requirement, add this as a comment in the pull request that Copilot raises.\n\n8. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available in the GitHub Copilot Pro+ and Copilot Enterprise plans.\n\n9. Optionally, if you are a GitHub Copilot Pro or GitHub Copilot Pro+ user, you can use the dropdown menu to select the model that Copilot will use. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n\nYou can also assign issues to Copilot from other places on GitHub.com:\n\n* From the list of issues on a repository's ** Issues** page.\n* When viewing an issue in GitHub Projects.\n\n### Assigning an issue to Copilot on GitHub Mobile\n\n1. In GitHub Mobile, navigate to the repository that contains the issue you want to assign to Copilot.\n2. Click **Issues**.\n3. Open the issue that you want to assign to Copilot.\n4. Tap the **** icon.\n5. Beside \"Assignees\", tap **Edit**.\n6. Beside \"Copilot\", click the plus sign.\n7. Click **Done**.\n\n### Assigning an issue to Copilot via the GitHub API\n\n> \\[!NOTE]\n> This feature is in public preview and subject to change.\n\nYou can assign issues to Copilot using either the GraphQL API or the REST API. Both APIs support an optional Agent Assignment input to customize the task:\n\n| GraphQL parameter | REST parameter | Description |\n| -------------------- | --------------------- | ---------------------------------------- |\n| `targetRepositoryId` | `target_repo` | The repository where Copilot will work |\n| `baseRef` | `base_branch` | The branch that Copilot will branch from |\n| `customInstructions` | `custom_instructions` | Additional instructions for Copilot |\n| `customAgent` | `custom_agent` | A custom agent to use for the task |\n| `model` | `model` | The model for Copilot to use |\n\n#### Using the GraphQL API\n\n> \\[!NOTE]\n> You must include the `GraphQL-Features` header with the values `issues_copilot_assignment_api_support` and `coding_agent_model_selection`.\n\nYou can use the following GraphQL mutations to assign issues to Copilot:\n\n* [`updateIssue`](/en/graphql/reference/mutations#updateissue)\n* [`createIssue`](/en/graphql/reference/mutations#createissue)\n* [`addAssigneesToAssignable`](/en/graphql/reference/mutations#addassigneestoassignable)\n* [`replaceActorsForAssignable`](/en/graphql/reference/mutations#replaceactorsforassignable)\n\n##### Creating and assigning a new issue\n\n1. Make sure you're authenticating with the API using a user token, for example a personal access token or a GitHub App user-to-server token.\n\n > \\[!NOTE]\n > If using a fine-grained personal access token, it needs the following permissions to assign Copilot to an issue:\n >\n > * Read access to metadata\n > * Read and write access to actions, contents, issues and pull requests\n >\n > If using a personal access token (classic), it needs the `repo` scope to assign Copilot to an issue.\n\n2. Verify that Copilot cloud agent is enabled in the repository by checking if the repository's `suggestedActors` in the GraphQL API includes Copilot. Replace `octo-org` with the repository owner, and `octo-repo` with the repository name.\n\n ```graphql copy\n query {\n repository(owner: \"octo-org\", name: \"octo-repo\") {\n suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {\n nodes {\n login\n __typename\n\n ... on Bot {\n id\n }\n\n ... on User {\n id\n }\n }\n }\n }\n }\n ```\n\n If Copilot cloud agent is enabled for the user and in the repository, the first node returned from the query will have the `login` value `copilot-swe-agent`.\n\n3. Make a note of the `id` value of this login.\n\n4. Fetch the GraphQL global ID of the repository you want to create the issue in, replacing `octo-org` with the repository owner, and `octo-repo` with the repository name.\n\n ```graphql copy\n query {\n repository(owner: \"octo-org\", name: \"octo-repo\") {\n id\n }\n }\n ```\n\n5. Create the issue with the `createIssue` mutation. Replace `REPOSITORY_ID` with the ID returned from the previous step, and `BOT_ID` with the ID returned from the step before that. You can optionally include the `agentAssignment` input to customize the task.\n\n ```shell copy\n gh api graphql -f query='mutation {\n createIssue(input: {\n repositoryId: \"REPOSITORY_ID\",\n title: \"Implement comprehensive unit tests\",\n body: \"DETAILS\",\n assigneeIds: [\"BOT_ID\"],\n agentAssignment: {\n targetRepositoryId: \"REPOSITORY_ID\",\n baseRef: \"main\",\n customInstructions: \"Add comprehensive test coverage\",\n customAgent: \"\",\n model: \"\"\n }\n }) {\n issue {\n id\n title\n assignees(first: 10) {\n nodes {\n login\n }\n }\n }\n }\n }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'\n ```\n\n##### Assigning an existing issue\n\n1. Make sure you're authenticating with the API using a user token, for example a personal access token or a GitHub App user-to-server token.\n\n2. Verify that Copilot cloud agent is enabled in the repository by checking if the repository's `suggestedActors` in the GraphQL API includes Copilot. Replace `octo-org` with the repository owner, and `octo-repo` with the repository name.\n\n ```graphql copy\n query {\n repository(owner: \"monalisa\", name: \"octocat\") {\n suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {\n nodes {\n login\n __typename\n\n ... on Bot {\n id\n }\n\n ... on User {\n id\n }\n }\n }\n }\n }\n ```\n\n If Copilot cloud agent is enabled for the user and in the repository, the first node returned from the query will have the `login` value `copilot-swe-agent`.\n\n3. Fetch the GraphQL global ID of the issue you want to assign to Copilot, replacing `monalisa` with the repository owner, `octocat` with the name and `9000` with the issue number.\n\n ```graphql copy\n query {\n repository(owner: \"monalisa\", name: \"octocat\") {\n issue(number: 9000) {\n id\n title\n }\n }\n }\n ```\n\n4. Assign the existing issue to Copilot using the `replaceActorsForAssignable` mutation. Replace `ISSUE_ID` with the ID returned from the previous step, `BOT_ID` with the ID returned from the step before that, and `REPOSITORY_ID` with the repository ID. You can optionally include the `agentAssignment` input to customize the task.\n\n ```shell copy\n gh api graphql -f query='mutation {\n replaceActorsForAssignable(input: {\n assignableId: \"ISSUE_ID\",\n actorIds: [\"BOT_ID\"],\n agentAssignment: {\n targetRepositoryId: \"REPOSITORY_ID\",\n baseRef: \"main\",\n customInstructions: \"Fix the reported bug\",\n customAgent: \"\",\n model: \"\"\n }\n }) {\n assignable {\n ... on Issue {\n id\n title\n assignees(first: 10) {\n nodes {\n login\n }\n }\n }\n }\n }\n }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'\n ```\n\n5. Alternatively, you can use the `updateIssue` mutation to update an existing issue and assign it to Copilot. Replace `ISSUE_ID` with the issue ID and `BOT_ID` with the bot ID.\n\n ```shell copy\n gh api graphql -f query='mutation {\n updateIssue(input: {\n id: \"ISSUE_ID\",\n assigneeIds: [\"BOT_ID\"],\n agentAssignment: {\n targetRepositoryId: \"REPOSITORY_ID\",\n baseRef: \"main\",\n customInstructions: \"Update feature implementation\",\n customAgent: \"\",\n model: \"\"\n }\n }) {\n issue {\n id\n title\n assignees(first: 10) {\n nodes {\n login\n }\n }\n }\n }\n }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'\n ```\n\n6. You can also use the `addAssigneesToAssignable` mutation to add Copilot to an existing issue while keeping other assignees. Replace `ISSUE_ID` with the issue ID and `BOT_ID` with the bot ID.\n\n ```shell copy\n gh api graphql -f query='mutation {\n addAssigneesToAssignable(input: {\n assignableId: \"ISSUE_ID\",\n assigneeIds: [\"BOT_ID\"],\n agentAssignment: {\n targetRepositoryId: \"REPOSITORY_ID\",\n baseRef: \"main\",\n customInstructions: \"Collaborate on this task\",\n customAgent: \"\",\n model: \"\"\n }\n }) {\n assignable {\n ... on Issue {\n id\n title\n assignees(first: 10) {\n nodes {\n login\n }\n }\n }\n }\n }\n }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'\n ```\n\n#### Using the REST API\n\nYou can use the following REST API endpoints to assign issues to Copilot:\n\n* [Add assignees to an issue](/en/rest/issues/assignees#add-assignees-to-an-issue)\n* [Create an issue](/en/rest/issues/issues#create-an-issue)\n* [Update an issue](/en/rest/issues/issues#update-an-issue)\n\n##### Adding assignees to an existing issue\n\n```shell copy\ngh api \\\n --method POST \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n /repos/OWNER/REPO/issues/ISSUE_NUMBER/assignees \\\n --input - <<< '{\n \"assignees\": [\"copilot-swe-agent[bot]\"],\n \"agent_assignment\": {\n \"target_repo\": \"OWNER/REPO\",\n \"base_branch\": \"main\",\n \"custom_instructions\": \"\",\n \"custom_agent\": \"\",\n \"model\": \"\"\n }\n}'\n```\n\n##### Creating a new issue\n\n```shell copy\ngh api \\\n --method POST \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n /repos/OWNER/REPO/issues \\\n --input - <<< '{\n \"title\": \"Issue title\",\n \"body\": \"Issue description.\",\n \"assignees\": [\"copilot-swe-agent[bot]\"],\n \"agent_assignment\": {\n \"target_repo\": \"OWNER/REPO\",\n \"base_branch\": \"main\",\n \"custom_instructions\": \"\",\n \"custom_agent\": \"\",\n \"model\": \"\"\n }\n}'\n```\n\n##### Updating an existing issue\n\n```shell copy\ngh api \\\n --method PATCH \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n /repos/OWNER/REPO/issues/ISSUE_NUMBER \\\n --input - <<< '{\n \"assignees\": [\"copilot-swe-agent[bot]\"],\n \"agent_assignment\": {\n \"target_repo\": \"OWNER/REPO\",\n \"base_branch\": \"main\",\n \"custom_instructions\": \"\",\n \"custom_agent\": \"\",\n \"model\": \"\"\n }\n}'\n```\n\n### Assigning an issue to Copilot from Raycast\n\n[Raycast](https://www.raycast.com/) is an extensible launcher for Windows and macOS. With the GitHub Copilot extension for Raycast, you can start and track Copilot cloud agent tasks and watch session logs live wherever you are on your computer.\n\n1. Install Raycast from the [Raycast website](https://www.raycast.com).\n2. Install the GitHub Copilot extension for Raycast by clicking the **Install Extension** button on the [extension's page](https://www.raycast.com/github/github-copilot).\n3. Open Raycast, search for \"Copilot,\" find the **Assign Issues to Copilot** command, then press Enter.\n4. Click **Sign in with GitHub**, then complete the authentication flow. Raycast will re-open.\n5. Select the repository you want Copilot to work in.\n6. Select the issue you want to assign to Copilot.\n7. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n8. Optionally, select a custom agent with specialized behavior and tools from the dropdown menu. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n9. Optionally, if you are a GitHub Copilot Pro or GitHub Copilot Pro+ user, you can use the dropdown menu to select the model that Copilot will use. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n10. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.\n11. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to assign the issue.\n\n Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n> \\[!NOTE]\n>\n> If you are unable to select a specific repository when starting a task, the organization that owns the repository may have enabled OAuth app access restrictions. To learn how to request approval for the \"GitHub Copilot for Raycast\" OAuth app, see [Requesting organization approval for OAuth apps](/en/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps).\n\n## Asking Copilot to create a pull request from the agents tab or panel\n\nYou can ask Copilot to open a pull request from either the agents tab or the agents panel. The only difference is the entry point - once you see the \"New agent task\" form, the steps are the same.\n\n1. Open the agents panel or tab:\n\n * Open the ** Agents** tab in a repository.\n * **Navigate to the agents page**: Go to [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text). You can also get here by opening the agents panel, then clicking **View all**.\n * **Open the agents panel**: Click in the navigation bar at the top right of GitHub.\n\n2. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.\n\n3. Type a prompt describing your request. You can also add visual inputs like screenshots or UI mockups by pasting, dragging, or uploading an image. Files supported: image/png, image/jpeg, image/gif, image/webp.\n\n For example, `Create a pull request to implement a user friendly message for common errors.`\n\n4. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n\n5. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available in the GitHub Copilot Pro+ and Copilot Enterprise plans.\n\n6. Optionally, if you are a GitHub Copilot Pro or GitHub Copilot Pro+ user, you can use the dropdown menu to select the model that Copilot will use. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n\n7. Click **** or press Enter.\n\n Copilot will start a new session, which will appear in the list below the prompt box. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n## Asking Copilot to create a pull request from the dashboard\n\nYou can ask Copilot to open a pull request from the Copilot prompt box in the dashboard. The dashboard is your personalized overview of your activity on GitHub, seen when you visit while logged in.\n\n1. Navigate to the dashboard at [https://github.com](https://github.com/?ref_product=desktop\\&ref_type=engagement\\&ref_style=text).\n\n2. Click the ** Task** button.\n\n3. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.\n\n4. Type a prompt describing your request.\n\n For example, `Create a pull request to implement a user friendly message for common errors.`\n\n5. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request.\n\n6. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available in the GitHub Copilot Pro+ and Copilot Enterprise plans.\n\n7. Click ** Send now** or press Return.\n\n You will be taken to the agents tab, and Copilot will start a new session, which will appear in the \"Recent sessions\" list below the prompt box. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n > \\[!NOTE]\n > If you have enabled the **New Dashboard Experience** in feature preview, the new session will appear in \"Agent sessions\" under the prompt box in your dashboard. For more information, see [Personal dashboard](/en/account-and-profile/reference/personal-dashboard#home-dashboard-view).\n\n## Asking Copilot to create a pull request from Copilot Chat in Visual Studio Code\n\n1. Install the [GitHub Pull Requests extension](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) for Visual Studio Code.\n\n2. Open GitHub Copilot Chat in Visual Studio Code.\n\n3. Type a prompt explaining what you want Copilot to do.\n\n For example, `Put backticks around file names and variables in output`\n\n > \\[!TIP]\n > To help Copilot, you can select the relevant line(s) of code before submitting your prompt.\n\n4. Submit your prompt by clicking the **Delegate this task to the GitHub Copilot cloud agent** button, next to the **Send** button\n\n5. If you have local changes, a dialog will be displayed asking if you want to push those changes so Copilot can start from your current state. Click **Include changes** to push your changes, or **Ignore changes** to ask Copilot to start its work from your repository's default branch.\n\n Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.\n\n## Asking Copilot to create a pull request from Copilot Chat in JetBrains IDEs\n\n> \\[!NOTE]\n> Copilot cloud agent in JetBrains IDEs is in public preview, and subject to change.\n\n1. Open GitHub Copilot Chat in your JetBrains IDE.\n\n2. Type a prompt explaining what you want Copilot to do\n\n For example, `Put backticks around file names and variables in output`\n\n3. Click the **Delegate to Cloud Agent** button next to the **Send** button.\n\n Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.\n\n## Asking Copilot to create a pull request from Copilot Chat in Eclipse\n\n> \\[!NOTE]\n> Copilot cloud agent in Eclipse is in public preview, and subject to change.\n\n1. Open GitHub Copilot Chat in Eclipse.\n\n2. Type a prompt explaining what you want Copilot to do.\n\n For example, `Put backticks around file names and variables in output`\n\n3. Click **** next to the **Send** button.\n\n4. In the dialog box that opens, select the repository you want Copilot to work in, then click **Continue**.\n\n Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.\n\n## Asking Copilot to create a pull request from Copilot Chat in Visual Studio 2026\n\n> \\[!NOTE] To use Copilot cloud agent in Visual Studio, you'll need to be running at least [December Update 18.1.0](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-notes#github-copilot-1) of Visual Studio 2026.\n\n1. Enable Copilot cloud agent support in Visual Studio.\n 1. Open the **Tools** menu, then click **Options**.\n 2. In the sidebar, select **GitHub**.\n 3. Check the **Enable Copilot Cloud agent (preview)** box.\n 4. Restart Visual Studio.\n\n2. Open GitHub Copilot Chat in Visual Studio.\n\n3. Enter a prompt, giving details of what you want Copilot to change.\n\n For example, `Put backticks around file names and variables in log output.`\n\n4. Submit your prompt by clicking the **Delegate this task to the GitHub Copilot cloud agent** button, next to the **Send** button.\n\n Copilot asks you to confirm that you want to use the cloud agent to create a pull request.\n\n5. Click **Confirm**.\n\n Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.\n\n## Asking Copilot to create a pull request from Copilot Chat in GitHub.com\n\n1. Open GitHub Copilot Chat on GitHub.com.\n\n2. Type `/task` to ask Copilot to create a pull request, and give details of what you want Copilot to change.\n\n For example, `/task Create a pull request to put backticks around file names and variables in output.`\n\n3. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n\n4. Optionally, you can click to open the agent dropdown menu, if you want to assign an agent or a custom agent with specialized behavior and tools. You can select an existing custom agent from your repository, organization, or enterprise. You can also click ** Create an agent** to create a new agent profile in your selected repository and branch. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n > \\[!NOTE] Third-party coding agents are available in the GitHub Copilot Pro+ and Copilot Enterprise plans.\n\n5. Click **** or press Enter.\n\n Copilot will start a new session, which will appear in the list below the prompt box. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n## Asking Copilot to create a pull request from GitHub Mobile\n\n1. In GitHub Mobile, navigate to the repository where you want to create a pull request.\n\n2. Tap the **** icon in the bottom right corner of the screen.\n\n3. Enter a prompt to ask Copilot to create a pull request.\n\n For example: `Create a pull request to ...`.\n\n Copilot responds with a brief summary of the task it will perform, asking for your confirmation before it proceeds.\n\n4. Check that Copilot has interpreted your prompt correctly, then tap **Accept** or **Dismiss**.\n\n Copilot creates a pull request and gives you a link to it. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.\n\n## Asking Copilot to create a pull request from the GitHub CLI\n\n> \\[!NOTE]\n> The `agent-task` command set is only available in v2.80.0 or later of the GitHub CLI. This command set is a public preview and is subject to change.\n\nYou can start a new Copilot cloud agent session with the `gh agent-task create` command in the GitHub CLI.\n\nWhen you run the command without any arguments, you are asked to enter a prompt. Copilot cloud agent acts on the prompt and opens a pull request in the current repository.\n\nYou can use command line options to:\n\n* Provide the prompt (`gh agent-task create \"Example prompt\"`)\n* Choose a base branch, instead of using the repository's default branch (`--base`)\n* Select a repository, instead of targeting the current repository (`--repo`)\n* Follow the session log in real time (`--follow`)\n\nTo see all of the available options, run `gh agent-task create --help`.\n\n## Asking Copilot to create a pull request from the GitHub MCP server\n\n> \\[!NOTE]\n>\n> * This capability is only available on the remote GitHub MCP server and host applications where remote MCP servers are supported.\n\n1. Install the GitHub MCP server in your preferred IDE or agentic coding tool. See [Using the GitHub MCP Server in your IDE](/en/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server).\n\n2. Ensure the `create_pull_request_with_copilot` tool is enabled.\n\n3. Open chat.\n\n4. Type a prompt asking Copilot to create a pull request, with the details of what you want to change.\n\n For example, `Open a PR in my repository to expand unit test coverage.`\n\n > \\[!TIP]\n >\n > * You can ask Copilot to open a pull request using a specific branch as the base branch by including it in your prompt.\n\n5. Submit your prompt.\n\n Copilot will start a new session, open a draft pull request and work on the task in the background. As it works, it will push changes to the pull request, and once it has finished, it will add you as a reviewer. In most cases, the MCP host will show you the URL of the created pull request.\n\n## Asking Copilot to create a pull request from Raycast\n\n[Raycast](https://www.raycast.com/) is an extensible launcher for Windows and macOS. With the GitHub Copilot extension for Raycast, you can start and track Copilot cloud agent tasks and watch session logs live wherever you are on your computer.\n\n1. Install Raycast from the [Raycast website](https://www.raycast.com).\n2. Install the GitHub Copilot extension for Raycast by clicking the **Install Extension** button on the [extension's page](https://www.raycast.com/github/github-copilot).\n3. Open Raycast, search for \"Copilot,\" find the **Create Task** command, then press Enter.\n4. Click **Sign in with GitHub**, then complete the authentication flow. Raycast will re-open.\n5. Type a prompt describing what you want Copilot to do.\n\n For example, `Implement a user friendly message for common errors.`\n6. Select the repository you want Copilot to work in.\n7. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n8. Optionally, select a custom agent with specialized behavior and tools from the dropdown menu. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).\n9. Optionally, if you are a GitHub Copilot Pro or GitHub Copilot Pro+ user, you can use the dropdown menu to select the model that Copilot will use. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n10. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to start the task.\n\n Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n> \\[!NOTE]\n>\n> If you are unable to select a specific repository when starting a task, the organization that owns the repository may have enabled OAuth app access restrictions. To learn how to request approval for the \"GitHub Copilot for Raycast\" OAuth app, see [Requesting organization approval for OAuth apps](/en/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps).\n\n## Asking Copilot to create a pull request from the \"New repository\" page\n\nWhen creating a new repository, you can ask Copilot to seed the new repository by entering a prompt.\n\n1. In the upper-right corner of any page, select , then click **New repository**.\n\n \n2. Use the **Owner** dropdown menu to select the account you want to own the repository.\n \n3. In the **Prompt** field, enter a prompt describing what you want Copilot to build.\n\n For example, `Create a Rust CLI for converting CSV spreadsheets to Markdown`\n4. Click **Create repository**.\n\n Copilot will immediately open a draft pull request. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n## Monitoring progress\n\nYou can view your current and past Copilot sessions from the agents panel, [agents page](https://github.com/copilot/agents), Visual Studio Code, and more. See [Tracking GitHub Copilot's sessions](/en/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).\n\n## Further reading\n\n* [About GitHub Copilot cloud agent](/en/copilot/concepts/agents/cloud-agent/about-cloud-agent)\n* [Best practices for using GitHub Copilot to work on tasks](/en/copilot/tutorials/cloud-agent/get-the-best-results)\n* [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents)\n* [Troubleshooting GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent#copilot-cant-create-a-pull-request-from-copilot-chat)"}