Remote - SSH

Establishes persistent SSH connections to remote hosts using OpenSSH-compatible clients with support for both password and key-based authentication. The extension manages SSH session lifecycle, credential handling, and connection state within VS Code's process model, enabling seamless switching between local and remote development contexts without requiring source code to exist locally.

Provides full read-write access to remote machine filesystems through VS Code's file explorer, enabling users to open, create, edit, and delete files on remote hosts as if they were local. The extension uses SSH's SFTP protocol layer to transfer file contents bidirectionally, with real-time change detection and conflict resolution, allowing simultaneous editing of remote files without requiring local copies.

Manages multiple simultaneous or sequential SSH connections to different remote machines, allowing developers to switch between remote development contexts without closing and reopening VS Code. The extension maintains a list of recently connected hosts and provides quick-access commands to reconnect or switch to different machines. Each connection maintains its own workspace context, extensions, and terminal sessions.

Supports SSH key-based authentication as the primary authentication method, with fallback to password-based authentication if keys are not available. The extension uses the local SSH client's key agent (ssh-agent) to provide keys for authentication, eliminating the need to enter passwords for each connection. If key-based authentication fails, the extension prompts for a password and uses password-based authentication as a fallback.

Provides integrated terminal access to the remote machine's shell environment, executing commands directly on the remote host with full access to the remote user's PATH, environment variables, and shell configuration. The extension spawns a remote shell session over SSH and pipes stdin/stdout/stderr through the VS Code terminal UI, inheriting the remote user's login environment without requiring manual shell initialization.

Establishes SSH port forwarding tunnels that map local ports to services running on the remote machine, enabling developers to access remote web servers, databases, or APIs as if they were running locally. The extension manages the SSH tunnel lifecycle and exposes forwarded ports through VS Code's port forwarding UI, with automatic detection of commonly-used ports and one-click forwarding setup.

Enables installation and execution of VS Code extensions directly on the remote machine's extension host, allowing extensions to access remote filesystem, processes, and environment without requiring code to be copied locally. The extension manager detects which extensions are compatible with the remote platform (x86_64, ARMv7l, ARMv8l) and handles installation of platform-specific native binaries, with fallback to local execution for extensions that don't support remote operation.

Supports SSH connections to diverse remote platforms (Linux x86_64/ARMv7l/ARMv8l, macOS 10.14+, Windows 10/Server 2016+) with automatic detection of remote architecture and OS, enabling appropriate binary selection for extensions and tools. The extension queries the remote system's uname output to determine platform capabilities and adjusts feature availability accordingly, with graceful degradation for unsupported platforms.

Exposes all remote SSH operations through VS Code's command palette with `Remote-SSH:` prefixed commands, providing discoverable access to connection management, folder opening, and configuration without requiring users to learn SSH syntax or terminal commands. Commands are context-aware, showing available remote hosts and suggesting next steps based on current connection state.

Manages environment variables and shell configuration on the remote machine to ensure that VS Code extensions and terminal sessions have access to the correct runtime environment. The extension sources shell configuration files (.bashrc, .zshrc, etc.) on the remote machine and applies environment variables to extension processes and terminal sessions, enabling language-specific tools (Python interpreters, Node.js, Go toolchain) to be discovered and used correctly.

Synchronizes VS Code workspace settings and extension configurations between local and remote contexts, allowing developers to maintain consistent editor behavior and extension settings across local and remote development. Settings can be configured to apply only locally, only remotely, or to both contexts, enabling per-machine customization while maintaining a shared configuration baseline. The extension stores remote-specific settings in the remote VS Code Server instance.

Automatically downloads, installs, and updates the VS Code Server component on the remote machine when establishing an SSH connection, eliminating manual server setup. The extension detects the remote machine's architecture and OS, downloads the appropriate VS Code Server binary, and installs it in a hidden directory on the remote machine. Updates are handled automatically when the local VS Code version changes, ensuring version compatibility between local and remote components.