Coder Remote Work

Coder Remote Work lets local VS Code connect to a remote Codework workspace and continue OpenCode agent sessions from an embedded VS Code panel.

Features

Connect VS Code to a Codework Agent Gateway with a gateway URL and client token.
Open the remote source directory through VS Code Remote - SSH.
View remote Agent sessions from the Activity Bar or Secondary Side Bar.
Open a session inside VS Code instead of jumping to a web page.
Send prompts from a fixed input box and receive live updates through WebSocket.
Start default OpenCode sessions on the remote workspace.
Stop sessions and review remote code changes through VS Code.
Use the bundled codework-acp-proxy command for ACP stdio clients.
Configure project, SSH, and Enterprise WeChat smart bot settings from a built-in settings page.
Sync project and Enterprise WeChat settings to the remote Gateway when settings are saved.

Requirements

VS Code 1.90.0 or later.
Microsoft Remote - SSH extension: ms-vscode-remote.remote-ssh.
A reachable Codework Agent Gateway.
A Codework client token.
SSH access to the remote workspace.
OpenCode configured on the remote workspace.

Setup

Install this extension from the VS Code Marketplace.
Install Remote - SSH.
Run Codework: Open Settings.
Enter the Gateway, remote project, SSH, and Enterprise WeChat settings.
Save settings. The extension stores local settings and syncs usable project and WeChat settings to the remote Gateway.
Run Codework: Open Remote Workspace to open the remote code directory.
Open the Codework side panel and start or continue an Agent session.

OpenCode provider URL, token, and model are configured on the remote Gateway, not in this extension.

Commands

Command	Purpose
`Codework: Connect Gateway`	Configure Gateway URL and token.
`Codework: Open Settings`	Open the built-in Codework settings page.
`Codework: Show Workspace Status`	Check remote workspace health.
`Codework: New Agent Session`	Create a new remote OpenCode session.
`Codework: Refresh Sessions`	Reload the remote session list.
`Codework: Open Right Sidebar`	Open the Codework panel in the Secondary Side Bar.
`Codework: Open Session Panel`	Open the selected session in VS Code.
`Codework: Stop Session`	Stop the current remote session.
`Codework: Open Remote Workspace`	Open the remote project through Remote - SSH.
`Codework: Show ACP Proxy Command`	Show the local ACP proxy command.
`Codework: Test ACP Proxy`	Test the ACP initialize handshake.
`Codework: Review Agent Changes`	Open VS Code diff for remote changes.

Settings

Codework: Open Settings uses a commented YAML editor:

# Gateway 地址：由管理员提供，插件用它访问远端 Agent Gateway。
gatewayUrl: "http://127.0.0.1:8080"

# Gateway token：由管理员提供。只保存在本地 VS Code settings，不会同步到远端。
clientToken: ""

# Workspace ID：当前第一版通常固定为 default。
workspaceId: "default"

# 默认 Agent：第一版使用 OpenCode，保持 opencode。
defaultAgent: "opencode"

# 远程项目目录：Agent 默认进入的代码目录。
defaultRepo: "/home/workspace/projects/ucloud-cli"

# Remote SSH Host Alias：写入本机 ~/.ssh/config 后，VS Code Remote - SSH 使用这个名字连接。
remoteSshHostAlias: "codework-default"

# Remote SSH Host：远程服务器公网或内网地址，由管理员提供。
remoteSshHost: "your-server.example.com"

# Remote SSH Port：远端暴露给 VS Code Remote - SSH 的端口。
remoteSshPort: 30022

# Remote SSH User：容器内开发用户，默认 workspace。
remoteSshUser: "workspace"

# 本机 SSH 私钥路径：插件会生成或使用这个私钥，并把公钥上传到远端。
remoteSshIdentityFile: "~/.ssh/codework_ed25519"

# 远程 workspace 根目录：远端项目都应放在这个目录下。
remoteWorkspaceRoot: "/home/workspace/projects"

# 是否启用企业微信智能机器人：Bot ID 和 Secret 来自企业微信智能机器人后台。
wecomSmartBotEnabled: false

# 企业微信智能机器人 Bot ID：从企业微信智能机器人后台复制。
wecomSmartBotId: ""

# 企业微信智能机器人 Secret：从企业微信智能机器人后台复制。
wecomSmartBotSecret: ""

# 企业微信连接方式：第一版固定使用长连接。
wecomSmartBotMode: "long_connection"

The extension checks required settings before opening remote workspaces, creating sessions, or starting ACP. If required settings are missing, it prompts the user to open the settings page.

The web frontend remains available as a personal admin backend. The extension does not expose web session links to end users.

Security

Treat the client token and SSH key as workspace credentials. Anyone with both can access the remote Codework workspace and its code.

Coder Remote Work