Connect to a WATcloud login node, bootstrap the environment, and see Slurm cluster status without leaving the editor.
- SSH key and cluster username (from WATcloud onboarding)
- Install from latest
vscode-watcloud-ui-*.vsix - Install from latest
vscode-watcloud-workspace-*.vsix
To view cluster status and start jobs, install the extension on the remote server:
- Navigate to the Extensions tab in the VS Code sidebar
- Find WATcloud Remote and click Install in SSH:
<login-node>
Auto-generate SSH Config adds wato-login1 / wato-login2 entries to ~/.ssh/config. Available in the view welcome screen when unconfigured.
Connect to Node via right-click a configured login node in the WATcloud view, or use the Command Palette. Opens a new Remote-SSH window and verifies the environment on first-time connection.
Login Nodes / Compute Nodes cluster view available on the local and remote VS Code server respectively. Use Refresh Login Nodes or Refresh Compute Nodes in the view title bar to update status.
Start Job — available from the Compute Nodes view title bar or Command Palette. Prompts for CPU, memory, GRES, and time, then submits an srun job and automatically opens a tunnel to the compute node in a new VS Code window.
First-time tunnel: GitHub authentication may be required the first time a tunnel is established. If the tunnel fails to connect, open the Output panel (
Ctrl+Shift+U/Cmd+Shift+U) and select WATcloud Tunnel from the dropdown to view the authentication link.
Prerequisites: Node.js, npm, and VS Code with the code CLI in your PATH.
packages/ui— Local extension. Login views, SSH config, connect, bootstrap. Installs the workspace extension via extensionPack.packages/workspace— Remote extension. Compute views, Slurm service, start job. Runs on the SSH remote.
# Install dependencies
npm install
# Compile both packages
npm run compile
# Watch mode (compile on change)
npm run watch# Package both extensions
npm run package
# Or package individually
npm run package:ui
npm run package:workspacenpm run install