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, 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 Windsurf).

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.

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://, windsurf://, 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.

Parameter	Required	Description
owner	Yes	Username of the workspace owner.
workspace	Yes	Name of the workspace.
agent	No	Agent name (not ID). If omitted or unmatched in a multi-agent workspace, a picker is shown.
folder	No	Absolute path inside the workspace to open. If omitted, a recently opened folder for this workspace is used (a picker is shown when there are several); with no recents, the window opens without a folder.
openRecent	No	Open the most recently used folder for this workspace, skipping the picker. True when present without a value or set to true. Ignored when folder is set.
url	No	Coder deployment URL. If omitted, the extension prompts for it (pre-filled with the current deployment).
token	No	Session token for authentication. If omitted, the existing session is used or a login flow is started.

/openDevContainer

Opens a dev container running inside a workspace.

Parameter	Required	Description
owner	Yes	Username of the workspace owner.
workspace	Yes	Name of the workspace.
agent	Yes	Agent name the dev container runs on.
devContainerName	Yes	Name of the dev container.
devContainerFolder	Yes	Folder to open inside the dev container.
localWorkspaceFolder	No	Local path of the dev container project. Required if localConfigFile is set.
localConfigFile	No	Local path to the devcontainer.json file.
url, token	No	Same as /open.