openai/codex · error · anyhow::Error

Forking with images requires a prompt

Error message

Forking with images requires a prompt

What it means

Error "Forking with images requires a prompt" thrown in openai/codex.

Source

Thrown at codex-rs/exec/src/lib.rs:770

                let mut items: Vec<UserInput> = imgs
                    .into_iter()
                    .chain(args.images.iter().cloned())
                    .map(|path| UserInput::LocalImage { path, detail: None })
                    .collect();
                items.push(UserInput::Text {
                    text: prompt_text.clone(),
                    text_elements: Vec::new(),
                });
                let output_schema = load_output_schema(output_schema_path);
                (
                    InitialOperation::UserTurn {
                        items,
                        output_schema,
                    },
                    prompt_text,
                )
            } else if !imgs.is_empty() || !args.images.is_empty() {
                anyhow::bail!("Forking with images requires a prompt");
            } else if output_schema_path.is_some() || last_message_file.is_some() {
                anyhow::bail!("Forking with output options requires a prompt");
            } else if config.ephemeral {
                anyhow::bail!("Ephemeral forks require a prompt");
            } else {
                (InitialOperation::ForkOnly, String::new())
            }
        }
        (None, root_prompt, imgs) => {
            let prompt_text = resolve_root_prompt(root_prompt);
            let mut items: Vec<UserInput> = imgs
                .into_iter()
                .map(|path| UserInput::LocalImage { path, detail: None })
                .collect();
            items.push(UserInput::Text {
                text: prompt_text.clone(),
                // CLI input doesn't track UI element ranges, so none are available here.
                text_elements: Vec::new(),

View on GitHub (pinned to 339751715c)

Solutions

1. Provide a prompt when forking with images.

When it happens

Trigger: Thrown at codex-rs/exec/src/lib.rs:770 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/f37baa23860d7eac. Report an issue: GitHub.