zed-industries/zed · error

Missing command {} after extraction

Error message

Missing command {} after extraction

What it means

After an agent server archive was downloaded and extracted, the configured `cmd` executable was not present at its expected location under the version directory. The artifact is incomplete, the cmd path in the registry config is wrong, or extraction laid files out differently.

Source

Thrown at crates/project/src/agent_server_store.rs:1293

                            &file_name,
                        )
                        .await?;
                    }
                }
            }

            let cmd = &target_config.cmd;

            let cmd_path = if cmd == "node" {
                node_runtime.binary_path().await?
            } else {
                if cmd.contains("..") {
                    anyhow::bail!("command path cannot contain '..': {}", cmd);
                }

                if cmd.starts_with("./") || cmd.starts_with(".\\") {
                    let cmd_path = version_dir.join(&cmd[2..]);
                    anyhow::ensure!(
                        fs.is_file(&cmd_path).await,
                        "Missing command {} after extraction",
                        cmd_path.to_string_lossy()
                    );
                    cmd_path
                } else {
                    anyhow::bail!("command must be relative (start with './'): {}", cmd);
                }
            };

            cx.background_spawn({
                let fs = fs.clone();
                let dir = dir.clone();
                let version_dir = version_dir.clone();
                async move {
                    remove_stale_versioned_archive_cache_dirs(fs, &dir, &version_dir)
                        .await
                        .log_err();

View on GitHub (pinned to 9d272b0363)

Solutions

1. Verify the `cmd` field in the registry/server configuration matches the artifact's actual layout
2. Re-download the artifact in case extraction was incomplete
3. Check that the archive's internal directory structure matches what the extractor expects

When it happens

Trigger: Thrown at crates/project/src/agent_server_store.rs:1293 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/a4f3767a8d718a4c. Report an issue: GitHub.