zed-industries/zed · error

no remote connection

Error message

no remote connection

What it means

In RemoteClient::build_command: remote_connection() returned None, so there is no active remote connection to translate the command into (no ssh/wsl/docker template). Fires when building commands for a dropped or never-established connection.

Source

Thrown at crates/remote/src/remote_client.rs:967

    pub fn default_system_shell(&self) -> Option<String> {
        Some(self.remote_connection()?.default_system_shell())
    }

    pub fn shares_network_interface(&self) -> bool {
        self.remote_connection()
            .map_or(false, |connection| connection.shares_network_interface())
    }

    pub fn has_wsl_interop(&self) -> bool {
        self.remote_connection()
            .map_or(false, |connection| connection.has_wsl_interop())
    }

    pub fn build_command(
        &self,
        program: Option<String>,
        args: &[String],
        env: &HashMap<String, String>,
        working_dir: Option<String>,
        port_forward: Option<(u16, String, u16)>,
        interactive: Interactive,
    ) -> Result<CommandTemplate> {
        let Some(connection) = self.remote_connection() else {
            return Err(anyhow!("no remote connection"));
        };
        connection.build_command(program, args, env, working_dir, port_forward, interactive)
    }

    pub fn build_forward_ports_command(
        &self,
        forwards: Vec<(u16, String, u16)>,
    ) -> Result<CommandTemplate> {
        let Some(connection) = self.remote_connection() else {
            return Err(anyhow!("no remote connection"));
        };

View on GitHub (pinned to 5a9b9558db)

Solutions

1. Establish the remote connection before building commands
2. Retry after reconnecting

When it happens

Trigger: Thrown at crates/remote/src/remote_client.rs:967 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@5a9b9558db (2026-08-20). Data as JSON: /api/errors/8f193f762ded9485. Report an issue: GitHub.