zed-industries/zed · error

remote worktrees can't yet load files

Error message

remote worktrees can't yet load files

What it means

Returned by Worktree::load_file when the worktree is the Remote variant. Reading file contents from a remote (collab) worktree is not implemented yet, so the task resolves immediately with this capability-gap sentinel.

Source

Thrown at crates/worktree/src/worktree.rs:926

        match self {
            Worktree::Local(this) => this.wait_for_snapshot(scan_id).boxed(),
            Worktree::Remote(this) => this.wait_for_snapshot(scan_id).boxed(),
        }
    }

    #[cfg(feature = "test-support")]
    pub fn has_update_observer(&self) -> bool {
        match self {
            Worktree::Local(this) => this.update_observer.is_some(),
            Worktree::Remote(this) => this.update_observer.is_some(),
        }
    }

    pub fn load_file(&self, path: &RelPath, cx: &Context<Worktree>) -> Task<Result<LoadedFile>> {
        match self {
            Worktree::Local(this) => this.load_file(path, cx),
            Worktree::Remote(_) => {
                Task::ready(Err(anyhow!("remote worktrees can't yet load files")))
            }
        }
    }

    pub fn load_binary_file(
        &self,
        path: &RelPath,
        cx: &Context<Worktree>,
    ) -> Task<Result<LoadedBinaryFile>> {
        match self {
            Worktree::Local(this) => this.load_binary_file(path, cx),
            Worktree::Remote(_) => {
                Task::ready(Err(anyhow!("remote worktrees can't yet load binary files")))
            }
        }
    }

    pub fn write_file(

View on GitHub (pinned to 9d272b0363)

Solutions

1. Open the file from the local project instead
2. Wait for remote file loading support

When it happens

Trigger: Thrown at crates/worktree/src/worktree.rs:920 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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