zed-industries/zed · error

terminal not yet supported for remote projects

Error message

terminal not yet supported for remote projects

What it means

Explicit capability guard in terminals_for_task: the project is remote (SSH/WSL) and spawning a task terminal is not yet implemented there, so the operation returns an error instead of opening a broken terminal.

Source

Thrown at crates/terminal_view/src/terminal_panel.rs:798

                    window,
                    cx,
                );
            })?;
            Ok(terminal.downgrade())
        })
    }

    pub fn add_terminal_task(
        &mut self,
        task: SpawnInTerminal,
        reveal_strategy: RevealStrategy,
        window: &mut Window,
        cx: &mut Context<Self>,
    ) -> Task<Result<WeakEntity<Terminal>>> {
        let workspace = self.workspace.clone();
        cx.spawn_in(window, async move |terminal_panel, cx| {
            if workspace.update(cx, |workspace, cx| !is_enabled_in_workspace(workspace, cx))? {
                anyhow::bail!("terminal not yet supported for remote projects");
            }
            let pane = terminal_panel.update(cx, |terminal_panel, _| {
                terminal_panel.pending_terminals_to_add += 1;
                terminal_panel.active_pane.clone()
            })?;
            let project = workspace.read_with(cx, |workspace, _| workspace.project().clone())?;
            let terminal = project
                .update(cx, |project, cx| project.create_terminal_task(task, cx))
                .await?;
            let result = workspace.update_in(cx, |workspace, window, cx| {
                let terminal_view = Box::new(cx.new(|cx| {
                    TerminalView::new(
                        terminal.clone(),
                        workspace.weak_handle(),
                        workspace.database_id(),
                        workspace.project().downgrade(),
                        window,
                        cx,

View on GitHub (pinned to f4178619ac)

Solutions

1. Run the task on a local project instead
2. Open a remote terminal manually and run the task command there
3. Await/upgrade to a Zed version with remote task-terminal support

When it happens

Trigger: Thrown at crates/terminal_view/src/terminal_panel.rs:798 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@f4178619ac (2026-08-20). Data as JSON: /api/errors/35e54613a59d8a4a. Report an issue: GitHub.