openai/codex · error · io::Error

Failed to read project config file {config_file_display}: {e

Error message

Failed to read project config file {config_file_display}: {err}

What it means

Error "Failed to read project config file {config_file_display}: {err}" thrown in openai/codex.

Source

Thrown at codex-rs/config/src/loader/mod.rs:1588

                    hooks_config_folder_override,
                    load_root_checkout_hooks: true,
                });
            }
            Err(err) => {
                if err.kind() == io::ErrorKind::NotFound {
                    // If there is no config.toml file, record an empty entry
                    // for this project layer, as this may still have subfolders
                    // that are significant in the overall ConfigLayerStack.
                    layers.push(DiscoveredProjectLayer {
                        dot_codex_folder: dot_codex_abs,
                        config: TomlValue::Table(toml::map::Map::new()),
                        disabled_reason,
                        hooks_config_folder_override,
                        load_root_checkout_hooks: true,
                    });
                } else {
                    let config_file_display = config_file.as_path().display();
                    return Err(io::Error::new(
                        err.kind(),
                        format!("Failed to read project config file {config_file_display}: {err}"),
                    ));
                }
            }
        }
    }

    Ok(DiscoveredProjectLayers {
        layers,
        startup_warnings,
    })
}

/// For linked worktrees, preserve ordinary worktree-local project config while
/// replacing only hook declarations with the matching root-checkout layer.
async fn merge_root_checkout_project_hooks(
    fs: &dyn ExecutorFileSystem,

View on GitHub (pinned to 339751715c)

Solutions

1. Check that the project config file exists and is readable.

When it happens

Trigger: Thrown at codex-rs/config/src/loader/mod.rs:1588 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/01244443f0b5c346. Report an issue: GitHub.