diff --git a/.gitignore b/.gitignore
index fd25f1b8..363f5842 100644
--- a/.gitignore
+++ b/.gitignore
@@ -99,3 +99,6 @@ crates/wasm/coverage/
 
 # VSCode
 /.vscode
+
+# Relay
+/.nemo-relay
diff --git a/docs/nemo-relay-cli/codex.mdx b/docs/nemo-relay-cli/codex.mdx
index 740bda6c..3edfdc44 100644
--- a/docs/nemo-relay-cli/codex.mdx
+++ b/docs/nemo-relay-cli/codex.mdx
@@ -57,6 +57,18 @@ nemo-relay run \
   -- codex
 ```
 
+<Warning>
+Place Codex `--config` overrides before the `exec` subcommand:
+
+```bash
+nemo-relay codex -- --config 'model_reasoning_effort="high"' exec "Summarize this repository."
+```
+
+Codex accepts overrides before or after `exec`, but treats overrides after
+`exec` as command-specific and gives them higher precedence than root-level
+overrides which can conflict with `--config` settings provided by Relay.
+</Warning>
+
 ## Persistent Plugin Install
 
 Install the persistent plugin for Codex. It should start normally and load