codex --help formatting bug: --config Examples line breaks are not preserved
Open 💬 2 comments Opened Mar 2, 2026 by ftnext
What version of Codex CLI is running?
codex-cli 0.106.0
What subscription do you have?
ChatGPT Plus
Which model were you using?
N/A (help output issue; model selection not involved)
What platform is your computer?
Darwin 23.5.0 arm64 arm
What terminal emulator and version are you using (if applicable)?
iTerm2 3.6.8
What issue are you seeing?
The --config help text in codex --help appears to have incorrect line wrapping in the Examples section.
Observed output:
Examples: - `-c model="o3"` - `-c
'sandbox_permissions=["disk-full-read-access"]'` - `-c
shell_environment_policy.inherit=all`
This makes the examples harder to read and can look malformed in narrow terminal widths.
What steps can reproduce the bug?
- Run:
codex --help
- Locate the
-c, --config <key=value>section. - Inspect the
Examplesblock. - In the affected build, examples are collapsed into one logical line and wrapped awkwardly.
What is the expected behavior?
The examples should preserve explicit line breaks, one example per line, e.g.:
Examples:
- `-c model="o3"`
- `-c 'sandbox_permissions=["disk-full-read-access"]'`
- `-c shell_environment_policy.inherit=all`
Additional information
A local fix was validated by adding verbatim_doc_comment to the --config Clap arg in codex-rs/utils/cli/src/config_override.rs and confirming the built binary prints the expected multi-line examples.
diff --git a/codex-rs/utils/cli/src/config_override.rs b/codex-rs/utils/cli/src/config_override.rs
index 1592563a0..2f6fb20f5 100644
--- a/codex-rs/utils/cli/src/config_override.rs
+++ b/codex-rs/utils/cli/src/config_override.rs
@@ -32,6 +32,7 @@ pub struct CliConfigOverrides {
value_name = "key=value",
action = ArgAction::Append,
global = true,
+ verbatim_doc_comment,
)]
pub raw_overrides: Vec<String>,
}This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗