codex-config loader README has stale layer precedence documentation

Open 💬 0 comments Opened Jun 1, 2026 by bar-d

What happened?

codex-rs/config/src/loader/README.md describes the config layer precedence as:

  1. MDM managed preferences
  2. System managed config
  3. Session flags
  4. User config

It also says precedence is “top overrides bottom”. The implementation comments in codex-rs/config/src/loader/mod.rs now describe a richer stack that includes admin/system requirements, system config, user config, selected profile config, cwd/tree/repo project config, and runtime overrides.

This makes the loader README look stale relative to the current config-loading model.

Expected behavior

The loader README should describe the current config layer stack and precedence model, including project/profile/runtime layers and the managed/requirements layers, so future changes and app-server config APIs have accurate internal documentation.

Additional context

I searched open issues and PRs for terms including codex-config, Layering model, Session flags, and project profile runtime config layers, and did not find an existing open item that appears to cover this README drift.

View original on GitHub ↗