microsoft / microsoft/vscode-docs
Document remote Dev Container agent sessions
Open
@ntrogh is already working on this.
Since Sep 17, 2026.
doc-enhancement
- Dominant language
- Markdown
- Stars
- 6.6k
- Forks
- 5.8k
- Avg merge
- 11h 43m
- Merged PRs (30d)
- 123
Description
Product change
- Source: https://github.com/microsoft/vscode/pull/336249
- Merged: 2026-09-16T15:37:25Z
Agents Window sessions can run in Dev Containers on supported SSH and Tunnel hosts. The workflow uses the existing workspace picker and chat.agentHost.devContainer.enabled setting. The source host must advertise the Dev Container capability, and unsupported or nested sources do not offer the option.
Why the docs need an update
docs/agents/run/agents-window.md documents Dev Container sessions only for eligible local folders. docs/agents/run/remote-agent-sessions.md does not explain how to select a Dev Container on an SSH or Tunnel host.
Suggested documentation
docs/agents/run/remote-agent-sessions.md: Add the remote Dev Container workflow, prerequisites, and availability constraints.docs/agents/run/agents-window.md: Update the existing Dev Container section to include supported remote source hosts.
Acceptance criteria
- Users can follow the documented picker flow for SSH and Tunnel Dev Containers.
- The setting, host-capability requirement, and unsupported nested-source constraint are accurate.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.