Starting GitHub Copilot sessions

Introduction

You can start Agent cloud Copilot from:

• GitHub Issues, by assigning an issue to Copilot
• The agents tab or panel on GitHub
• The dashboard on GitHub
• Discussion avec Copilot in Visual Studio Code, JetBrains IDEs, Eclipse and Visual Studio 2026
• Discussion avec Copilot on GitHub.com
• The GitHub CLI
• On GitHub Mobile
• Your preferred IDE or agentic coding tool with Model Context Protocol (MCP) support
• The Raycast launcher
• The "New repository" form on GitHub
• Jira
• Slack
• Microsoft Teams
• Azure Boards
• Linear

Copilot will start working on the task in the background. Some entry points open a pull request automatically. In other cases, you can prompt Copilot to open a pull request, or create a pull request when Copilot finishes work, from the session logs.

For more information, see À propos de GitHub Copilot agent cloud.

Assigning an issue to Copilot

You can ask Copilot to start working on an issue by assigning the issue to Copilot.

Copilot will start working on the task, raise a pull request, then request a review from you when it's finished working

You can assign an issue to Copilot:

• On GitHub.com (see the next section)
• On GitHub Mobile
• Via the GitHub API (see later in this article)
• Using the Raycast launcher
• Using GitHub CLI (see gh issue edit)

Assigning an issue to Copilot on GitHub.com

1. Sur GitHub, accédez à la page principale du référentiel.

2. Sous le nom de votre référentiel, cliquez sur Problèmes.

   

3. Open the issue that you want to assign to Copilot.

4. In the right side menu, click Assignees.

   

5. Click Copilot from assignees list.

   

   Additional options are displayed.

   

6. 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.

   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.

   In addition to the details you supply here, Copilot will use any custom instructions that have been configured for the target repository. See Ajout d’instructions personnalisées de référentiel pour GitHub Copilot.

7. 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.

   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 Agent cloud Copilot is enabled for that repository.

   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.

   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.

   Conseil

   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.

8. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils assistant personnalisé. Vous pouvez sélectionner un élément existant assistant personnalisé à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau profil d’agent dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

   Remarque

   Les agents de codage tiers sont disponibles dans les plans GitHub Copilot Pro+ et Copilot Entreprise.

9. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

You can also assign issues to Copilot from other places on GitHub.com:

• From the list of issues on a repository's Issues page.
• When viewing an issue in GitHub Projets.

Assigning an issue to Copilot on GitHub Mobile

1. In GitHub Mobile, navigate to the repository that contains the issue you want to assign to Copilot.
2. Click Issues.
3. Open the issue that you want to assign to Copilot.
4. Tap the icon.
5. Beside "Assignees", tap Edit.
6. Beside "Copilot", click the plus sign.
7. Click Done.

Assigning an issue to Copilot via the GitHub API

You 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:

Using the GraphQL API

You can use the following GraphQL mutations to assign issues to Copilot:

• updateIssue
• createIssue
• addAssigneesToAssignable
• replaceActorsForAssignable

Creating and assigning a new issue

1. 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.

   Remarque

   If using a fine-grained personal access token, it needs the following permissions to assign Copilot to an issue:

   • Read access to metadata
   • Read and write access to actions, contents, issues and pull requests

   If using a personal access token (classic), it needs the repo scope to assign Copilot to an issue.

2. Verify that Agent cloud Copilot 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.

   GraphQL

   query {
     repository(owner: "octo-org", name: "octo-repo") {
       suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
         nodes {
           login
           __typename
   
           ... on Bot {
             id
           }
   
           ... on User {
             id
           }
         }
       }
     }
   }
   

   If Agent cloud Copilot is enabled for the user and in the repository, the first node returned from the query will have the login value copilot-swe-agent.

3. Make a note of the id value of this login.

4. 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.

   GraphQL

   query {
     repository(owner: "octo-org", name: "octo-repo") {
       id
     }
   }
   

5. 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.

   Shell

   gh api graphql -f query='mutation {
     createIssue(input: {
       repositoryId: "REPOSITORY_ID",
       title: "Implement comprehensive unit tests",
       body: "DETAILS",
       assigneeIds: ["BOT_ID"],
       agentAssignment: {
         targetRepositoryId: "REPOSITORY_ID",
         baseRef: "main",
         customInstructions: "Add comprehensive test coverage",
         customAgent: "",
         model: ""
       }
     }) {
       issue {
         id
         title
         assignees(first: 10) {
           nodes {
             login
           }
         }
       }
     }
   }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
   

Assigning an existing issue

1. 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.

2. Verify that Agent cloud Copilot 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.

   GraphQL

   query {
     repository(owner: "monalisa", name: "octocat") {
       suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
         nodes {
           login
           __typename
   
           ... on Bot {
             id
           }
   
           ... on User {
             id
           }
         }
       }
     }
   }
   

   If Agent cloud Copilot is enabled for the user and in the repository, the first node returned from the query will have the login value copilot-swe-agent.

3. 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.

   GraphQL

   query {
     repository(owner: "monalisa", name: "octocat") {
       issue(number: 9000) {
         id
         title
       }
     }
   }
   

4. 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.

   Shell

   gh api graphql -f query='mutation {
     replaceActorsForAssignable(input: {
       assignableId: "ISSUE_ID",
       actorIds: ["BOT_ID"],
       agentAssignment: {
         targetRepositoryId: "REPOSITORY_ID",
         baseRef: "main",
         customInstructions: "Fix the reported bug",
         customAgent: "",
         model: ""
       }
     }) {
       assignable {
         ... on Issue {
           id
           title
           assignees(first: 10) {
             nodes {
               login
             }
           }
         }
       }
     }
   }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
   

5. 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.

   Shell

   gh api graphql -f query='mutation {
     updateIssue(input: {
       id: "ISSUE_ID",
       assigneeIds: ["BOT_ID"],
       agentAssignment: {
         targetRepositoryId: "REPOSITORY_ID",
         baseRef: "main",
         customInstructions: "Update feature implementation",
         customAgent: "",
         model: ""
       }
     }) {
       issue {
         id
         title
         assignees(first: 10) {
           nodes {
             login
           }
         }
       }
     }
   }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
   

6. 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.

   Shell

   gh api graphql -f query='mutation {
     addAssigneesToAssignable(input: {
       assignableId: "ISSUE_ID",
       assigneeIds: ["BOT_ID"],
       agentAssignment: {
         targetRepositoryId: "REPOSITORY_ID",
         baseRef: "main",
         customInstructions: "Collaborate on this task",
         customAgent: "",
         model: ""
       }
     }) {
       assignable {
         ... on Issue {
           id
           title
           assignees(first: 10) {
             nodes {
               login
             }
           }
         }
       }
     }
   }' -H 'GraphQL-Features: issues_copilot_assignment_api_support,coding_agent_model_selection'
   

Using the REST API

You can use the following REST API endpoints to assign issues to Copilot:

• Add assignees to an issue
• Create an issue
• Update an issue

Adding assignees to an existing issue

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER/assignees \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER/assignees \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

Creating a new issue

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues \
  --input - <<< '{
  "title": "Issue title",
  "body": "Issue description.",
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues \
  --input - <<< '{
  "title": "Issue title",
  "body": "Issue description.",
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

Updating an existing issue

gh api \
  --method PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

gh api \
  --method PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER \
  --input - <<< '{
  "assignees": ["copilot-swe-agent[bot]"],
  "agent_assignment": {
    "target_repo": "OWNER/REPO",
    "base_branch": "main",
    "custom_instructions": "",
    "custom_agent": "",
    "model": ""
  }
}'

Assigning an issue to Copilot from Raycast

Raycast est un lanceur extensible pour Windows et macOS. Avec l’extension GitHub Copilot de Raycast, vous pouvez démarrer et suivre Agent cloud Copilot les tâches et regarder les journaux de session en direct où que vous soyez sur votre ordinateur.

1. Installez Raycast depuis le site web de Raycast.

2. Installez l’extension GitHub Copilot pour Raycast en cliquant sur le bouton Installer l’extension sur la page de l’extension.

3. Open Raycast, search for "Copilot," find the Assign Issues to Copilot command, then press Enter.

4. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

5. Select the repository you want Copilot to work in.

6. Select the issue you want to assign to Copilot.

7. 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.

8. Si vous le souhaitez, sélectionnez un assistant personnalisé avec un comportement et des outils spécialisés dans le menu déroulant. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

9. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

10. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.

11. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to assign the issue.

    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.

Asking Copilot to start work from the agents tab or panel

You can ask start sessions from the agents tab and the agents panel. The only difference is the entry point - once you see the "New agent task" form, the steps are the same.

1. Ouvrez le panneau ou l’onglet agents :

   • Ouvrez l' onglet Agents dans un référentiel.
   • Accédez à la page des assistants : rendez-vous sur github.com/copilot/agents. Vous pouvez également y accéder en ouvrant le panneau des assistants, puis en cliquant sur Afficher tout.
   • Ouvrez le panneau des assistants : cliquez sur dans la barre de navigation en haut à droite de GitHub.

2. À l’aide du menu déroulant dans le champ de saisie, sélectionnez le référentiel dans lequel vous souhaitez Copilot travailler.

3. Saisissez une invite décrivant votre demande. Vous pouvez également ajouter des entrées visuelles telles que des captures d’écran ou des maquettes d’interface utilisateur en collant, en faisant glisser ou en chargeant une image. Fichiers pris en charge : image/png, image/jpeg, image/gif, image/webp.

   Par exemple : Create a pull request to implement a user friendly message for common errors.

4. Si vous le souhaitez, sélectionnez une branche de base pour la pull request de Copilot. Copilot créera une nouvelle branche basée sur cette branche, puis poussera les modifications vers une pull request ciblant cette branche.

5. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils assistant personnalisé. Vous pouvez sélectionner un élément existant assistant personnalisé à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau profil d’agent dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

   Remarque

   Les agents de codage tiers sont disponibles dans les plans GitHub Copilot Pro+ et Copilot Entreprise.

6. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

7. Cliquez ou appuyez sur Entrée.

          Copilot démarre une nouvelle session, qui apparaît dans la liste sous la zone d’invite. 
          Copilot travaillera sur la tâche et poussera les modifications dans sa pull request, puis vous ajoutera en tant que réviseur une fois terminé, ce qui déclenchera une notification.
   

Asking Copilot to start work from the dashboard

You 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 https://github.com while logged in.

1. Navigate to the dashboard at https://github.com.

2. Click the Task button.

3. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.

4. Type a prompt describing your request.

   For example, Implement a user friendly message for common errors.

   If you want Copilot to open a pull request, you can ask in your prompt, for example Open a pull request to implement a user friendly message for common errors.

5. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch.

6. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils assistant personnalisé. Vous pouvez sélectionner un élément existant assistant personnalisé à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau profil d’agent dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

   Remarque

   Les agents de codage tiers sont disponibles dans les plans GitHub Copilot Pro+ et Copilot Entreprise.

7. Click Send now or press Return.

   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 any code changes.

   Remarque

   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 Tableau de bord personnel.

Asking Copilot to create a pull request from Discussion avec Copilot in Visual Studio Code

1. Install the GitHub Pull Requests extension for Visual Studio Code.

2. Open GitHub Copilot Chat in Visual Studio Code.

3. Type a prompt explaining what you want Copilot to do.

   For example, Put backticks around file names and variables in output

   Conseil

   To help Copilot, you can select the relevant line(s) of code before submitting your prompt.

4. Submit your prompt by clicking the Delegate this task to the GitHub Copilot cloud agent button, next to the Send button

5. 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.

   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.

Asking Copilot to create a pull request from Discussion avec Copilot in JetBrains IDEs

1. Open GitHub Copilot Chat in your JetBrains IDE.

2. Type a prompt explaining what you want Copilot to do

   For example, Put backticks around file names and variables in output

3. Click the Delegate to Cloud Agent button next to the Send button.

   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.

Asking Copilot to create a pull request from Discussion avec Copilot in Eclipse

1. Open GitHub Copilot Chat in Eclipse.

2. Type a prompt explaining what you want Copilot to do.

   For example, Put backticks around file names and variables in output

3. Click next to the Send button.

4. In the dialog box that opens, select the repository you want Copilot to work in, then click Continue.

   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.

Asking Copilot to create a pull request from Discussion avec Copilot in Visual Studio 2026

1. Enable Agent cloud Copilot support in Visual Studio.

   1. Open the Tools menu, then click Options.
   2. In the sidebar, select GitHub.
   3. Check the Enable Copilot Cloud agent (preview) box.
   4. Restart Visual Studio.

2. Open GitHub Copilot Chat in Visual Studio.

3. Enter a prompt, giving details of what you want Copilot to change.

   For example, Put backticks around file names and variables in log output.

4. Submit your prompt by clicking the Delegate this task to the GitHub Copilot cloud agent button, next to the Send button.

   Copilot asks you to confirm that you want to use the cloud agent to create a pull request.

5. Click Confirm.

   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.

Asking Copilot to create a pull request from Discussion avec Copilot in GitHub.com

1. Open GitHub Copilot Chat on GitHub.com.

2. Type /task to ask Copilot to create a pull request, and give details of what you want Copilot to change.

   For example, /task Create a pull request to put backticks around file names and variables in output.

3. 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.

4. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils assistant personnalisé. Vous pouvez sélectionner un élément existant assistant personnalisé à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau profil d’agent dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

   Remarque

   Les agents de codage tiers sont disponibles dans les plans GitHub Copilot Pro+ et Copilot Entreprise.

5. Click or press Enter.

   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.

Asking Copilot to start work from GitHub Mobile

1. In GitHub Mobile, tap the icon in the bottom right corner of the screen, then tap New Session.

2. Using the dropdown menu in the prompt field, select the repository you want Copilot to work in.

3. Enter a prompt describing your request.

   For example: Implement a user friendly message for common errors..

   If you want Copilot to open a pull request, you can ask in your prompt, for example Open a pull request to implement a user friendly message for common errors.

4. Optionally, select a base branch for Copilot's changes. Copilot will create a new branch based on this branch.

5. Si vous le souhaitez, sélectionnez un assistant personnalisé avec un comportement et des outils spécialisés dans le menu déroulant. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

6. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

7. Click the submit button.

   Copilot will start a new session, work on the task and push any code changes.

   You can track Copilot's work and open a pull request in one click from the session logs. For more information, see Suivi des sessions de GitHub Copilot.

Asking Copilot to create a pull request from the GitHub CLI

You can start a new Agent cloud Copilot session with the gh agent-task create command in the GitHub CLI.

When you run the command without any arguments, you are asked to enter a prompt. Agent cloud Copilot acts on the prompt and opens a pull request in the current repository.

You can use command line options to:

• Provide the prompt (gh agent-task create "Example prompt")
• Choose a base branch, instead of using the repository's default branch (--base)
• Select a repository, instead of targeting the current repository (--repo)
• Follow the session log in real time (--follow)

To see all of the available options, run gh agent-task create --help.

Asking Copilot to create a pull request from the GitHub MCP server

1. Install the GitHub MCP server in your preferred IDE or agentic coding tool. See Utilisation du serveur MCP GitHub dans votre IDE.

2. Ensure the create_pull_request_with_copilot tool is enabled.

3. Open chat.

4. Type a prompt asking Copilot to create a pull request, with the details of what you want to change.

   For example, Open a PR in my repository to expand unit test coverage.

   Conseil

   • You can ask Copilot to open a pull request using a specific branch as the base branch by including it in your prompt.

5. Submit your prompt.

   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.

Asking Copilot to create a pull request from Raycast

Raycast est un lanceur extensible pour Windows et macOS. Avec l’extension GitHub Copilot de Raycast, vous pouvez démarrer et suivre Agent cloud Copilot les tâches et regarder les journaux de session en direct où que vous soyez sur votre ordinateur.

1. Installez Raycast depuis le site web de Raycast.

2. Installez l’extension GitHub Copilot pour Raycast en cliquant sur le bouton Installer l’extension sur la page de l’extension.

3. Open Raycast, search for "Copilot," find the Create Task command, then press Enter.

4. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

5. Type a prompt describing what you want Copilot to do.

   For example, Implement a user friendly message for common errors.

6. Select the repository you want Copilot to work in.

7. 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.

8. Si vous le souhaitez, sélectionnez un assistant personnalisé avec un comportement et des outils spécialisés dans le menu déroulant. Pour plus d’informations, consultez « Création d’agents personnalisés pour Agent cloud Copilot ».

9. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

10. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to start the task.

    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.

Asking Copilot to create a pull request from the "New repository" page

When creating a new repository, you can ask Copilot to seed the new repository by entering a prompt.

1. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur , puis cliquez sur Nouveau référentiel.

   

2. Utilisez le menu déroulant Propriétaire pour sélectionner le compte auquel vous voulez donner la propriété du dépôt.

   

3. In the Prompt field, enter a prompt describing what you want Copilot to build.

   For example, Create a Rust CLI for converting CSV spreadsheets to Markdown

4. Cliquez sur Créer le dépôt.

   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.

Contrôle de la progression

Vous pouvez afficher vos sessions actuelles et passées Copilot à partir du panneau des agents, de la page des agents, Visual Studio Code et bien plus encore. Consultez « Suivi des sessions de GitHub Copilot ».

Further reading

• À propos de GitHub Copilot agent cloud
• Bonnes pratiques pour l’utilisation de GitHub Copilot pour travailler sur des tâches
• Création d’agents personnalisés pour Agent cloud Copilot
• Résolution des problèmes de l'agent du cloud GitHub Copilot