Remote - SSH

Establishes and manages SSH connections to remote machines by parsing SSH configuration, handling authentication (key-based or password), and maintaining persistent connection state. Uses OpenSSH-compatible client protocol to create a secure tunnel that bridges VS Code's local instance with a remote VS Code Server component running on the target host, enabling all subsequent remote operations through this single authenticated channel.

Opens and mounts remote filesystem folders as VS Code workspaces by establishing a virtual filesystem bridge over the SSH connection. The extension creates a remote workspace context where all file operations (read, write, search, indexing) execute on the remote machine rather than locally, with file metadata and content streamed back to the local VS Code UI. This enables full workspace features (file tree, search, source control) to operate on remote files without copying them locally.

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.

Proxies VS Code's integrated terminal to the remote machine's shell, creating a bidirectional channel where terminal input/output flows over the SSH connection. When a terminal is opened in VS Code while connected to a remote host, the extension spawns a shell process on the remote machine and streams its output back to the local terminal UI, while forwarding local keyboard input to the remote shell. This enables running remote commands, scripts, and interactive tools directly from VS Code's terminal panel.

Manages the installation, activation, and execution of VS Code extensions on the remote machine, enabling extensions to run in the remote context where they can access remote files, processes, and system resources. When an extension is installed while connected to a remote host, the extension is downloaded and installed on the remote machine's VS Code Server instance rather than locally. The extension then executes in the remote process, giving it access to remote filesystem, terminal, and debugging APIs.

Establishes port forwarding tunnels from the local machine to services running on the remote machine, enabling local tools and browsers to access remote services as if they were running locally. The extension creates a listener on a local port that forwards traffic over the SSH connection to a specified port on the remote machine, allowing developers to access remote web servers, databases, APIs, and other services using localhost URLs. Port forwarding can be configured manually via command palette or automatically detected from running processes.

Enables attaching VS Code's debugger to processes running on the remote machine, allowing developers to set breakpoints, inspect variables, and step through code executing on the remote server. The extension proxies debugging protocol (DAP - Debug Adapter Protocol) messages between the local VS Code debugger UI and remote debugger backends (gdb, lldb, node-inspect, etc.), creating a transparent debugging experience where breakpoints and variable inspection work identically to local debugging.

Integrates Git and other source control systems with remote repositories by executing git commands on the remote machine where the repository is located. When VS Code's source control panel is used while connected to a remote host, git commands (commit, push, pull, branch operations) are executed on the remote machine, and the results are displayed in the local VS Code UI. This enables full source control workflows without requiring local repository clones.

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.