microsoft · ntrogh · May 27, 2025 · May 13, 2025 · May 13, 2025 · May 13, 2025
diff --git a/blogs/2025/05/27/add-dev-container-config-command.png b/blogs/2025/05/27/add-dev-container-config-command.png
diff --git a/blogs/2025/05/27/ai-and-remote.md b/blogs/2025/05/27/ai-and-remote.md
@@ -0,0 +1,133 @@
+---
+Order: 100
+TOCTitle: Enhance productivity with AI + Remote Dev
+PageTitle: "Enhance productivity with AI + Remote Dev"
+MetaDescription: Enhance your developer productivity with AI and Remote Development.
+MetaSocialImage: ai-remote-development-social.png
+Date: 2025-05-27
+Author: Brigit Murtaugh, Christof Marti, Josh Spicer, Olivia Guzzardo McVicker
+---
+
+# Enhance productivity with AI + Remote Dev
+
+May 27th, 2025 by [Brigit Murtaugh](https://github.com/bamurtaugh), [Christof Marti](https://github.com/chrmarti), [Josh Spicer](https://github.com/joshspicer), [Olivia Guzzardo McVicker](https://github.com/olguzzar)
+
+One of the features that makes VS Code so flexible and powerful is [Remote Development](/docs/remote/remote-overview.md). Whether you're connecting to a secure VM from your local desktop, a hugely powerful computer from your tablet, or a containerized environment with all the dependencies your project needs – VS Code's ability to develop _anything from anywhere_ can help in just about any setup.
+
+Now combine those capabilities with the flexibility and power of AI in VS Code, and you have an incredibly versatile dev environment. You can ensure chat conversations have context about your remote workspace, get AI help in setting up and debugging remote connections, and provide a more isolated space for agent mode to work autonomously.
+
+In this blog, we'll explore how your existing remote setups can be enhanced to "just work" with AI, along with some more customized AI + remote workflows that include custom instructions, chat participants, and agent auto-approvals.
+
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com//embed/ErYP9LRo7e0?si=1zYHow_2ivCc0jzd" title="AI and Remote Development in VS Code" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+## What is Remote Development?
+
+When we describe VS Code Remote Development, we refer to five main experiences:
+* [Remote - SSH](/docs/remote/ssh.md) - Connect to any location by opening folders on a remote machine/VM using SSH.
+* [Dev Containers](/docs/devcontainers/containers.md) - Work with a separate toolchain or container-based application inside (or mounted into) a container.
+* [WSL](/docs/remote/wsl.md) - Get a Linux-powered development experience in the Windows Subsystem for Linux.
+* [Remote - Tunnels](/docs/remote/tunnels.md) - Connect to a remote machine via a secure tunnel, without configuring SSH.
+* [GitHub Codespaces](/docs/remote/codespaces.md) - Remote environments that are managed for you.
+
+![Remote architecture](/docs/remote/images/remote-overview/architecture.png)
+
+## How can you use AI in a remote environment?
+
+We want to make the AI coding experience in VS Code as seamless as possible, whether you're working on your local machine or connected to a remote environment. If you're already using GitHub Copilot locally, we'll automatically install it remotely. And GitHub Codespaces has it configured too!
+
+While using AI in a remote environment will just work, there are additional AI features that can make your remote workflow even more powerful:
+* Custom instructions - Tailor your AI experience for your remote environment
+* Chat participants - Use chat to set up and troubleshoot your remote environment
+* Tool approvals - Run autonomous coding sessions safely in remote environments
+
+## Tailor your AI experience for your remote environment
+
+One of the top requests we hear from users when working with an LLM is: How can I help the LLM better understand my code and coding practices? You can achieve this via **custom instructions**, which describe common guidelines or rules to get responses that match your specific coding practices and tech stack. Instead of manually including this context in every AI chat query, custom instructions automatically incorporate this information with every chat request (learn more in our [recent blog post](/blogs/2025/03/26/custom-instructions.md)).
+
+In our team's recent self-hosting, we found it helpful to use custom instructions to not only tell Copilot about our code and coding practices, but to also provide more information about the type of remote environment we're connected to, such as:
+* What kind of remote environment is this (i.e. a dev container vs a VM)?
+* What languages or toolchains are installed? What's their purpose?
+* Where are toolchains installed (i.e. are they available on the `PATH`)?
+
+Here's an example instruction our team found helpful:
+
+```markdown
+This is a dev container that includes `python3` and `pip3` pre-installed and available on the `PATH`, along with the Python language extensions for Python development.
+```
+
+To get started with custom instructions in a remote environment, you can use the same [instruction files](/docs/copilot/copilot-customization.md) remotely that you were already using locally.
+
+## Configure AI for your dev container
+
+Dev containers make it easier to get started with a project by having all tools and dependencies preconfigured. By adding custom instructions, you can make sure that the LLM is tailored to that environment instead of providing generic answers. For example, a dev container for Python coding might have custom instructions about which tools are installed, or which coding guidelines to follow (as shared in the example above).
+
+Our team has taken steps to preconfigure custom instructions to make your life even easier when using dev containers. We publish dev container resources (like images and Features) to ease the process of creating and connecting to dev containers, and we now include custom instructions in these files. Here’s an example of how you can use the custom dev container instructions our team added:
+
+* Create a new dev container configuration using one of our images or Features. You could do this by hand, or via the **Dev Containers: Add Dev Container Configuration Files...** command supplied by the [Dev Containers extension](https://marketplace.visualstudio.com/search?term=dev%20containers&target=VSCode&category=All%20categories&sortBy=Relevance):
+
+    ![Dev Containers: Add Dev Container Configuration Files command in VS Code Command Palette](add-dev-container-config-command.png)
+
+* Follow the steps in the quick pick. For this example, we'll select the Python Template:
+
+    ![Select Python 3 dev container config in VS Code Command Palette](python-container.png)
+
+* Build and connect to your dev container in VS Code:
+
+    ![VS Code notification to reopen project in dev container](reopen-container-notif.png)
+
+* The environment you've selected and are now connected to is based on [our Python Template](https://github.com/devcontainers/templates/tree/main/src/python), which [includes custom instructions via the Python Feature](https://github.com/devcontainers/features/blob/main/src/python/devcontainer-feature.json#L80). Try chatting with Copilot within your dev container - Copilot automatically pulls the custom instructions from the Python image!
+
+    ![AI chat using custom instructions](chat-using-instructions.png)
+
+In addition to using the custom instructions we've added to images and Features, you can add additional custom instructions to the `devcontainer.json` in your projects - we've made it so that custom instructions can merge successfully across images and Templates. You can use the `"github.copilot.chat.codeGeneration.instructions"` setting, just like what we did in the Python dev container config described above.
+
+If you [publish](https://containers.dev/collections) any dev container configurations for others to use, we recommend exploring how you might add custom instructions to them! [Here](https://github.com/devcontainers/features/blob/main/src/python/devcontainer-feature.json#L80) is an example of using custom instructions in a Python dev container Feature:
+
+```json
+"github.copilot.chat.codeGeneration.instructions": [
+    {
+        "text": "This dev container includes `python3` and `pip3` pre-installed and available on the `PATH`, along with the Python language extensions for Python development."
+    }
+],
+```
+
+## Use chat to set up and troubleshoot your remote environment
+
+_Chat participants_ enhance your chat experience by providing domain-specific knowledge, such as how to interact with a database or a specific API. Type `@` in the chat input field to view and select from the list of available participants - they'll be available in Ask mode. There are several built-in chat participants like `@workspace`, `@vscode`, and `@terminal`. Extensions can also contribute chat participants.
+
+The Remote - SSH extension includes a Copilot chat participant. Ask `@remote-ssh` for help configuring or troubleshooting elements of your remote environment:
+
+![Using Remote - SSH participant in VS Code chat panel](remote-ssh-intro.png)
+
+The participant is also knowledgeable about general SSH and remote development topics:
+
+![Asking Remote - SSH participant about remote auth](remote-ssh-auth.png)
+
+If a connection failure occurs, the **Diagnose with Copilot** feature provides a quick way to understand the problem:
+
+![Diagnose with Copilot option in notification](ssh-diagnose.png)
+
+Copilot will investigate the issue and provide actionable insights:
+
+<video src="analyzing.mp4" title="Copilot diagnosing connection issue" autoplay muted controls></video>
+
+## Run autonomous coding sessions safely in remote environments
+
+As part of completing the tasks for a user prompt, [agent mode](/docs/copilot/chat/chat-agent-mode.md) can run tools and terminal commands. Agent mode is powerful because it not only proposes code changes but can also run terminal commands and tools. For example, it can install project dependencies or run tests. However, some of these actions might be destructive, such as deleting files, modifying local configuration, and more. Therefore, you need to approve the use of tools and terminal commands in agent mode.
+
+![Agent mode tool approval options dropdown](chat-tool-approval.png)
+
+In case you want to auto-approve _all_ tools, you can now use the experimental `chat.tools.autoApprove` setting. To give you some level of protection against inadvertent terminal commands or tool calls, you can choose to only set this in a dev container or remote machine to prevent your local dev machine from getting affected:
+
+![Auto Approve tool setting in VS Code remote settings](auto-approval.png)
+
+This will auto-approve all tools, and VS Code will not ask for confirmation when a language model wishes to run tools. This can help save time by giving more autonomy to agent mode, but bear in mind that with this setting enabled, you will not have the opportunity to cancel potentially destructive actions a model wants to take.
+
+Note that remote environments that are part of your local machine (like dev containers) or that have access to your credentials will pose different levels of risk.
+
+## What's Next
+
+We're excited about the future of Remote Development and AI in VS Code. Our monthly releases are packed with exciting new features, and we're constantly looking ahead to what's next, like supporting Copilot Chat [in the web](/docs/setup/vscode-web.md) ([vscode.dev](http://vscode.dev/microsoft/vscode), [github.dev](http://github.dev/microsoft/vscode)).
+
+Happy (smart and remote) coding!
+Brigit, Christof, Josh, and Olivia
diff --git a/blogs/2025/05/27/ai-remote-development-social.png b/blogs/2025/05/27/ai-remote-development-social.png
diff --git a/blogs/2025/05/27/analyzing.mp4 b/blogs/2025/05/27/analyzing.mp4
diff --git a/blogs/2025/05/27/auto-approval.png b/blogs/2025/05/27/auto-approval.png
diff --git a/blogs/2025/05/27/chat-tool-approval.png b/blogs/2025/05/27/chat-tool-approval.png
diff --git a/blogs/2025/05/27/chat-using-instructions.png b/blogs/2025/05/27/chat-using-instructions.png
diff --git a/blogs/2025/05/27/python-container.png b/blogs/2025/05/27/python-container.png
diff --git a/blogs/2025/05/27/remote-ssh-auth.png b/blogs/2025/05/27/remote-ssh-auth.png
diff --git a/blogs/2025/05/27/remote-ssh-intro.png b/blogs/2025/05/27/remote-ssh-intro.png
diff --git a/blogs/2025/05/27/reopen-container-notif.png b/blogs/2025/05/27/reopen-container-notif.png
diff --git a/blogs/2025/05/27/ssh-diagnose.png b/blogs/2025/05/27/ssh-diagnose.png