Merge pull request #43638 from github/repo-sync

Repo sync

Author: docs-bot

content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md

@@ -110,3 +110,5 @@ Some features on {% data variables.enterprise.data_residency_site %} are current
 ### {% data variables.product.prodname_github_codespaces %}
 
 {% data variables.product.prodname_github_codespaces %} on {% data variables.enterprise.data_residency_site %} are in {% data variables.release-phases.public_preview %} and are available in all {% data variables.enterprise.data_residency %} regions: EU, Australia, US, and Japan.
+
+To use {% data variables.product.prodname_github_codespaces %} from {% data variables.product.prodname_vscode_shortname %} desktop with an enterprise on {% data variables.enterprise.data_residency_site %}, you must configure the `Github-enterprise: Uri` and `Github > Codespaces: Auth Provider` settings. For more information, see [AUTOTITLE](/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code#connecting-to-an-enterprise-on-ghecom).

content/billing/concepts/product-billing/github-copilot-premium-requests.md

@@ -61,9 +61,9 @@ When you use {% data variables.copilot.copilot_coding_agent %}, including any {%
 * **{% data variables.product.prodname_actions %} minutes** come from your account’s monthly allowance of free minutes for {% data variables.product.github %}-hosted runners. This allowance is shared with all {% data variables.product.prodname_actions %} workflows. See [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#included-storage-and-minutes).
 * **Premium requests** come from the monthly allowance associated with your {% data variables.product.prodname_copilot_short %} license. This allowance is shared with other features, such as {% data variables.copilot.copilot_chat_short %}.
 
-Each coding agent **session** consumes one premium request. A session begins when you:
+Each cloud agent **session** consumes one premium request. A session begins when you:
 
-* Ask {% data variables.product.prodname_copilot_short %} to create or edit a pull request
+* Prompt {% data variables.product.prodname_copilot_short %} to undertake a task.
 * Assign {% data variables.product.prodname_copilot_short %} to an issue
 
 If you run out of free minutes or premium requests, and you have _not_ set up billing, a message is displayed explaining why {% data variables.product.prodname_copilot_short %} cannot work on the task.

content/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md

@@ -40,6 +40,39 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the
 1. When you're prompted to specify what you want to authorize, click the **Authorize** button for "{% data variables.product.prodname_dotcom %}."
 1. If the authorization page is displayed, click **Authorize Visual-Studio-Code**.
 
+{% ifversion ghec %}
+
+## Connecting to an enterprise on {% data variables.enterprise.data_residency_site %}
+
+If you access {% data variables.product.github %} through a subdomain of {% data variables.enterprise.data_residency_site %}, you must configure the  `Github-enterprise: Uri` and `Github > Codespaces: Auth Provider` settings in {% data variables.product.prodname_vscode_shortname %} before you can connect to your codespaces.
+
+1. To open your {% data variables.product.prodname_vscode_shortname %} settings, press <kbd>Command</kbd>+<kbd>,</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>,</kbd> (Windows).
+1. In the search bar, search for `enterprise`.
+1. For the `Github-enterprise: Uri` setting, enter the URL where you access {% data variables.product.github %}. For example: `https://{% data variables.enterprise.data_residency_example_domain %}`.
+
+   Alternatively, you can add the following to your `settings.json` file:
+
+   ```json copy
+   "github-enterprise.uri": "https://{% data variables.enterprise.data_residency_domain %}"
+   ```
+
+1. In the {% data variables.product.prodname_vscode_shortname %} settings, search for `Codespaces Auth Provider`.
+1. For the `Github > Codespaces: Auth Provider` setting, select `github-enterprise` from the dropdown.
+
+   Alternatively, you can add the following to your `settings.json` file:
+
+   ```json copy
+   "github.codespaces.authProvider": "github-enterprise"
+   ```
+
+1. You will be shown a prompt asking you to sign in. Click **Sign in to {% data variables.product.github %}**, then follow the prompts to authorize your account.
+
+   If you **don't see the prompt**, try restarting {% data variables.product.prodname_vscode_shortname %}.
+
+If you ever need to switch back to an account on {% data variables.product.prodname_dotcom_the_website %}, set the `Github > Codespaces: Auth Provider` setting back to its default value and remove the `Github-enterprise: Uri` setting.
+
+{% endif %}
+
 ## Creating a codespace in {% data variables.product.prodname_vscode_shortname %}
 
 {% data reusables.codespaces.creating-a-codespace-in-vscode %}

content/copilot/concepts/agents/coding-agent/about-coding-agent.md

@@ -1,7 +1,8 @@
 ---
-title: About GitHub Copilot coding agent
-shortTitle: About coding agent
-intro: You can ask {% data variables.product.prodname_copilot_short %} to open a new pull request or make changes to an existing pull request. {% data variables.product.prodname_copilot_short %} works in the background, then requests a review from you.
+title: About GitHub Copilot cloud agent
+shortTitle: About cloud agent
+allowTitleToDifferFromFilename: true
+intro: '{% data variables.product.prodname_copilot_short %} can research a repository, create an implementation plan, and make code changes on a branch. You can review the diff, iterate, and create a pull request when you''re ready.'
 product: '{% data reusables.gated-features.copilot-coding-agent %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
 versions:
   feature: copilot
@@ -18,41 +19,47 @@ contentType: concepts
 category:
   - Learn about Copilot
 ---
-
-## Overview of {% data variables.copilot.copilot_coding_agent %}
-
+<!-- expires 2026-04-21 -->
+<!-- When this expires, search all references to {% data variables.copilot.copilot_cloud_agent_tmp %} in docs-internal and replace with {% data variables.copilot.copilot_coding_agent %} -->
+## Overview of {% data variables.copilot.copilot_cloud_agent_tmp %}
+<!-- end expires 2026-04-21 -->
 With {% data variables.copilot.copilot_coding_agent %}, {% data variables.product.prodname_copilot %} can work independently in the background to complete tasks, just like a human developer.
 
 {% data variables.copilot.copilot_coding_agent %} can:
 
+* Research a repository
+* Create implementation plans
 * Fix bugs
 * Implement incremental new features
 * Improve test coverage
 * Update documentation
 * Address technical debt
 * Resolve merge conflicts
 
-To delegate tasks to {% data variables.copilot.copilot_coding_agent %}, you can:
+When you delegate tasks to {% data variables.copilot.copilot_coding_agent %}, you can:
 
-* Ask Copilot to open a new pull request from many places, including {% data variables.product.prodname_github_issues %}, {% data variables.product.prodname_vscode %} and the agents panel available on every page on {% data variables.product.github %}. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr).
+* Use the agents panel or other agents entry points on {% data variables.product.prodname_dotcom_the_website %} to have {% data variables.product.prodname_copilot_short %} research, plan, and make code changes on a branch, then iterate before creating a pull request. You can also specify in your prompt that you want a pull request created right away. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate).
+* Ask {% data variables.product.prodname_copilot_short %} to open a new pull request from other entry points, including {% data variables.product.prodname_github_issues %} and {% data variables.product.prodname_vscode %}. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr).
 * Mention `@copilot` in a comment on an existing pull request to ask it to make changes. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr).
 {% ifversion security-campaigns-assign-to-cca %}* Assign security alerts to {% data variables.product.prodname_copilot_short %} from security campaigns. See [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign#assigning-alerts-to-copilot-coding-agent).{% endif %}
 
-{% data variables.copilot.copilot_coding_agent %} will evaluate the task it has been assigned based on the prompt you give it—whether that's from the issue description or a chat message. Then {% data variables.copilot.copilot_coding_agent %} will make the required changes and open a pull request. When {% data variables.copilot.copilot_coding_agent %} finishes, it will request a review from you, and you can leave pull request comments to ask {% data variables.copilot.copilot_coding_agent %} to iterate.
+{% data variables.copilot.copilot_coding_agent %} will evaluate the task it has been assigned based on the prompt you give it.
 
 While working on a coding task, {% data variables.copilot.copilot_coding_agent %} has access to its own ephemeral development environment, powered by {% data variables.product.prodname_actions %}, where it can explore your code, make changes, execute automated tests and linters and more.
 
+> [!NOTE] Deep research, planning, and iterating on code changes before creating a pull request are only available with {% data variables.copilot.copilot_coding_agent %} on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.copilot.copilot_coding_agent_short_cap_c %} integrations (such as Azure Boards, JIRA, Linear, Slack, or Teams) only support creating a pull request directly.
+
 ### Benefits over traditional AI workflows
 
 When used effectively, {% data variables.copilot.copilot_coding_agent %} offers productivity benefits over traditional AI assistants in IDEs:
 
 * With **AI assistants in IDEs**, coding happens **locally**. Individual developers pair in **synchronous** sessions with the AI assistant. Decisions made during the session are **untracked** and lost to time unless committed. Although the assistant helps write code, the developer still has a lot of **manual steps** to do: create the branch, write commit messages, push the changes, open the PR, write the PR description, get a review, iterate in the IDE, and repeat. These steps take time and effort that may be hard to justify for simple or routine issues.
 
-* With **{% data variables.copilot.copilot_coding_agent %}**, all coding and iterating happens **on {% data variables.product.github %}** as part of the pull request workflow. You can create multiple {% data variables.copilot.custom_agents_short %} that specialize in different types of tasks. {% data variables.product.prodname_copilot_short %} **automates** branch creation, commit message writing and pushing, PR opening, and PR description writing. Developers let the agents **work in the background** and then steer {% data variables.product.prodname_copilot_short %} to a final solution using PR reviews. Working on {% data variables.product.github %} adds **transparency**, with every step happening in a commit and being viewable in logs, and opens up **collaboration** opportunities for the entire team.
+* With **{% data variables.copilot.copilot_coding_agent %}**, all coding and iterating happens **on {% data variables.product.github %}**. You can ask {% data variables.product.prodname_copilot_short %} to **research** a repository, **create a plan**, and **make code changes** on a branch—all before opening a pull request. You can create multiple {% data variables.copilot.custom_agents_short %} that specialize in different types of tasks. {% data variables.product.prodname_copilot_short %} **automates** branch creation, commit message writing, and pushing. Developers let the agents **work in the background** and then chooses to **create a pull request** when ready. Working on {% data variables.product.github %} adds **transparency**, with every step happening in a commit and being viewable in logs, and opens up **collaboration** opportunities for the entire team.
 
 ## {% data variables.copilot.copilot_coding_agent %} versus agent mode
 
-{% data variables.copilot.copilot_coding_agent %} is distinct from the "agent mode" feature available in your IDE. {% data variables.copilot.copilot_coding_agent %} works autonomously in a {% data variables.product.prodname_actions %}-powered environment to complete development tasks assigned through {% data variables.product.github %} issues or {% data variables.copilot.copilot_chat %} prompts, and creates pull requests with the results. In contrast, agent mode in your IDE makes autonomous edits directly in your local development environment. For more information about agent mode, see [AUTOTITLE](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide).
+{% data variables.copilot.copilot_coding_agent %} is distinct from the "agent mode" feature available in your IDE. {% data variables.copilot.copilot_coding_agent %} works autonomously in a {% data variables.product.prodname_actions %}-powered environment to complete development tasks assigned through {% data variables.product.github %} issues or {% data variables.copilot.copilot_chat %} prompts. It can research a repository, create a plan, make code changes on a branch, and optionally open a pull request. In contrast, agent mode in your IDE makes autonomous edits directly in your local development environment. For more information about agent mode, see [AUTOTITLE](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide).
 
 ## Streamlining software development with {% data variables.copilot.copilot_coding_agent %}
 
@@ -62,6 +69,8 @@ For example, you can assign {% data variables.copilot.copilot_coding_agent %} to
 
 Having {% data variables.copilot.copilot_coding_agent %} as an additional coding resource also allows you to start tasks that you might not have otherwise started due to lack of resources. For example, you might create issues to refactor code or add more logging, and then immediately assign these to {% data variables.product.prodname_copilot_short %}.
 
+You can also use {% data variables.copilot.copilot_coding_agent %} to research a repository and create a plan before any code is written, helping you understand how a codebase works or agree on an approach before committing to changes. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate).
+
 {% data variables.copilot.copilot_coding_agent %} can start a task, which you then pick up and continue working on yourself. By assigning the initial work to {% data variables.product.prodname_copilot_short %}, you free up time that you would otherwise have spent doing repetitive tasks, such as setting up the scaffolding for a new project.
 
 You can create specialized {% data variables.copilot.custom_agents_short %} for different tasks. For example, you might create a {% data variables.copilot.copilot_custom_agent_short %} specialized for frontend development that focuses on React components and styling, a documentation agent that excels at writing and updating technical documentation, or a testing agent that specializes in generating comprehensive unit tests. Each {% data variables.copilot.copilot_custom_agent_short %} can be tailored with specific prompts and tools suited to its particular task.
@@ -138,7 +147,7 @@ You can customize {% data variables.copilot.copilot_coding_agent %} in a number
 
 * **{% data variables.product.prodname_copilot_short %} can only make changes in the repository specified when you start a task**. {% data variables.product.prodname_copilot_short %} cannot make changes across multiple repositories in one run.
 * **By default, {% data variables.product.prodname_copilot_short %} can only access context in the repository specified when you start a task**. The {% data variables.product.prodname_copilot_short %} MCP server is configured by default to allow {% data variables.product.prodname_copilot_short %} to access context (for example issues and historic pull requests) in the repository where it is working. You can, however, configure broader access. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp).
-* **{% data variables.product.prodname_copilot_short %} can only open one pull request at a time**. {% data variables.product.prodname_copilot_short %} will open exactly one pull request to address each task it is assigned.
+* **{% data variables.product.prodname_copilot_short %} can only work on one branch at a time** and can open exactly one pull request to address each task it is assigned.
 
 ### Limitations in {% data variables.copilot.copilot_coding_agent %}'s compatibility with other features
 

content/copilot/concepts/agents/coding-agent/access-management.md

@@ -1,5 +1,5 @@
 ---
-title: Managing access to GitHub Copilot coding agent
+title: Managing access to GitHub Copilot cloud agent
 shortTitle: Access management
 allowTitleToDifferFromFilename: true
 intro: Find out about {% data variables.copilot.copilot_coding_agent %} policies available for {% data variables.copilot.copilot_enterprise %} and {% data variables.copilot.copilot_for_business %}, and about disabling the agent for specific repositories.

content/copilot/concepts/agents/coding-agent/index.md

@@ -1,8 +1,8 @@
 ---
-title: Concepts for GitHub Copilot coding agent
+title: Concepts for GitHub Copilot cloud agent
 shortTitle: '{% data variables.copilot.copilot_coding_agent_short_cap_c %}'
 allowTitleToDifferFromFilename: true
-intro: Learn how {% data variables.copilot.copilot_coding_agent %} can carry out coding tasks for you, working independently in the same workflow you use yourself.
+intro: Learn how {% data variables.copilot.copilot_coding_agent %} can carry out research, planning and coding tasks for you, working independently in the same workflow you use yourself.
 versions:
   feature: copilot
 children:

content/copilot/concepts/agents/coding-agent/mcp-and-coding-agent.md

@@ -1,5 +1,5 @@
 ---
-title: Model Context Protocol (MCP) and GitHub Copilot coding agent
+title: Model Context Protocol (MCP) and GitHub Copilot cloud agent
 shortTitle: MCP and {% data variables.copilot.copilot_coding_agent_short %}
 allowTitleToDifferFromFilename: true
 intro: Find out about using the Model Context Protocol (MCP) with {% data variables.copilot.copilot_coding_agent %}.

content/copilot/concepts/agents/coding-agent/risks-and-mitigations.md

@@ -1,5 +1,5 @@
 ---
-title: Risks and mitigations for GitHub Copilot coding agent
+title: Risks and mitigations for GitHub Copilot cloud agent
 shortTitle: Risks and mitigations
 intro: 'How do {% data variables.copilot.copilot_coding_agent %}''s built-in security protections mitigate known risks?'
 versions:

content/copilot/concepts/auto-model-selection.md

@@ -40,10 +40,11 @@ Experience less rate limiting and reduce the mental load of choosing a model by
 
 When you select **Auto** in {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} may choose from the following list of models, subject to your policies and subscription type. Models may change over time.
   * {% data variables.copilot.copilot_gpt_41 %}
-  * {% data variables.copilot.copilot_gpt_52_codex %}
   * {% data variables.copilot.copilot_gpt_53_codex %}
+  * {% data variables.copilot.copilot_gpt_54 %}
+  * {% data variables.copilot.copilot_gpt_54_mini %}
   * {% data variables.copilot.copilot_claude_haiku_45 %}
-  * {% data variables.copilot.copilot_claude_sonnet_45 %}
+  * {% data variables.copilot.copilot_claude_sonnet_46 %}
   * {% data variables.copilot.copilot_grok_code %}
   * {% data variables.copilot.copilot_raptor_mini %}