Coder Remote

The Coder Remote extension connects your editor to Coder workspaces with a single click.

Features

• One-click workspace access - open workspaces from the Coder dashboard or the editor sidebar. Workspaces start automatically when opened.
• Multi-editor support - works with VS Code, Cursor, Devin Desktop (formerly Windsurf), and other VS Code forks.
• Workspace sidebar - browse, search, and create workspaces. View agent metadata and app statuses at a glance.
• Coder Tasks - create, monitor, and manage AI agent tasks directly from the sidebar with real-time log streaming.
• Multi-deployment support - connect to multiple Coder deployments and switch between them without losing credentials.
• Dev container support - open dev containers running inside workspaces.
• Secure authentication - session tokens stored in the OS keyring (macOS/Windows), with optional OAuth 2.1 support.
• Air-gapped / restricted networks - no external dependencies beyond your Coder deployment.
• Automatic SSH tuning - applies recommended SSH settings for reliable long-lived connections and recovers from sleep/wake.

[!NOTE] The extension builds on VS Code-provided implementations of SSH. Make sure you have the correct SSH extension installed for your editor (ms-vscode-remote.remote-ssh, anysphere.remote-ssh for Cursor, or codeium.windsurf-remote-openssh for Devin Desktop).

Getting Started

Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.

ext install coder.coder-remote

Alternatively, manually install the VSIX from the latest release.

All extension settings are under the coder.* namespace in the Settings UI. Paths in settings accept ~ and ${userHome} from VS Code's variables reference. Several coder.* settings (paths, commands, hostnames, and proxy bypass lists) are excluded from Settings Sync via ignoreSync, because their values can depend on the specific machine or network where they were set.

[!WARNING] Do not give any coder.* setting "scope": "machine". In a remote window VS Code filters machine-scoped keys out of the local User settings.json, so such a value only holds until the extension registers its schema on activation. After that, the next re-parse of settings.json (from an edit, a Settings Sync write, a profile switch, or a tasks.json load) drops the value back to its default, with no remote-side copy to fall back on. This intermittent revert is the cause of #1032. Use application scope instead: it is honored in remote windows regardless of timing. See #1034 for the mechanism and reproduction.

URI Handler

The extension registers a URI handler that can open workspaces from outside the editor, such as links on the Coder dashboard. The scheme matches the editor (vscode://, cursor://, devin://, etc.), followed by the extension ID and a path:

vscode://coder.coder-remote/open?owner=alice&workspace=dev&agent=main&folder=/home/coder/project

/open

Opens a workspace, starting it first if needed.

/openDevContainer

Opens a dev container running inside a workspace.