openai/codex · error · anyhow::Error

zsh fork feature enabled, but no packaged zsh fork is availa

Error message

zsh fork feature enabled, but no packaged zsh fork is available for this install

What it means

Error "zsh fork feature enabled, but no packaged zsh fork is available for this install" thrown in openai/codex.

Source

Thrown at codex-rs/core/src/session/session.rs:1147

                    .model_reasoning_summary
                    .unwrap_or(ReasoningSummaryConfig::Auto),
                config.model_context_window,
                config.model_auto_compact_token_limit,
                config.permissions.approval_policy.value(),
                config
                    .permissions
                    .legacy_sandbox_policy(session_configuration.cwd().as_path()),
                mcp_server_names.iter().map(String::as_str).collect(),
            );

            let use_zsh_fork_shell = config.features.enabled(Feature::ShellZshFork);
            let default_shell = if let Some(user_shell_override) =
                session_configuration.user_shell_override.clone()
            {
                user_shell_override
            } else if use_zsh_fork_shell {
                let zsh_path = config.zsh_path.as_ref().ok_or_else(|| {
                    anyhow::anyhow!(
                        "zsh fork feature enabled, but no packaged zsh fork is available for this install"
                    )
                })?;
                if zsh_path.is_file() {
                    shell::Shell {
                        shell_type: shell::ShellType::Zsh,
                        shell_path: zsh_path.clone(),
                    }
                } else {
                    shell::get_shell(shell::ShellType::Zsh).ok_or_else(|| {
                        anyhow::anyhow!(
                            "zsh fork feature enabled, but packaged zsh fork `{}` is not usable",
                            zsh_path.display()
                        )
                    })?
                }
            } else {
                shell::default_user_shell()

View on GitHub (pinned to 339751715c)

Solutions

1. Disable the zsh fork feature, or install a Codex build that packages the zsh fork.

When it happens

Trigger: Thrown at codex-rs/core/src/session/session.rs:1147 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/17881ac20d2e2a35. Report an issue: GitHub.