{"record":{"id":"17881ac20d2e2a35","repo":"openai/codex","slug":"zsh-fork-feature-enabled-but-no-packaged-zsh-fork","errorCode":null,"errorMessage":"zsh fork feature enabled, but no packaged zsh fork is available for this install","messagePattern":"zsh fork feature enabled, but no packaged zsh fork is available for this install","errorType":"exception","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"codex-rs/core/src/session/session.rs","lineNumber":1147,"sourceCode":"                    .model_reasoning_summary\n                    .unwrap_or(ReasoningSummaryConfig::Auto),\n                config.model_context_window,\n                config.model_auto_compact_token_limit,\n                config.permissions.approval_policy.value(),\n                config\n                    .permissions\n                    .legacy_sandbox_policy(session_configuration.cwd().as_path()),\n                mcp_server_names.iter().map(String::as_str).collect(),\n            );\n\n            let use_zsh_fork_shell = config.features.enabled(Feature::ShellZshFork);\n            let default_shell = if let Some(user_shell_override) =\n                session_configuration.user_shell_override.clone()\n            {\n                user_shell_override\n            } else if use_zsh_fork_shell {\n                let zsh_path = config.zsh_path.as_ref().ok_or_else(|| {\n                    anyhow::anyhow!(\n                        \"zsh fork feature enabled, but no packaged zsh fork is available for this install\"\n                    )\n                })?;\n                if zsh_path.is_file() {\n                    shell::Shell {\n                        shell_type: shell::ShellType::Zsh,\n                        shell_path: zsh_path.clone(),\n                    }\n                } else {\n                    shell::get_shell(shell::ShellType::Zsh).ok_or_else(|| {\n                        anyhow::anyhow!(\n                            \"zsh fork feature enabled, but packaged zsh fork `{}` is not usable\",\n                            zsh_path.display()\n                        )\n                    })?\n                }\n            } else {\n                shell::default_user_shell()","sourceCodeStart":1129,"sourceCodeEnd":1165,"githubUrl":"https://github.com/openai/codex/blob/339751715c64496cb86246bfb3935f40e309dd3d/codex-rs/core/src/session/session.rs#L1129-L1165","documentation":"Error \"zsh fork feature enabled, but no packaged zsh fork is available for this install\" thrown in openai/codex.","triggerScenarios":"Thrown at codex-rs/core/src/session/session.rs:1147 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Disable the zsh fork feature, or install a Codex build that packages the zsh fork."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"339751715c64496cb86246bfb3935f40e309dd3d","analyzedAt":"2026-08-25T05:35:09.876Z","schemaVersion":2},"datasetVersion":"2026-08-25T06:17:31.827Z"}