docs: simplify codex mcp install

Author: CharlieGreenman

CHANGELOG.md

@@ -6,7 +6,7 @@ All notable changes to `state-trace` are documented here. The format roughly fol
 
 ### Changed
 
-- Clarified MCP install docs to mirror Geometra's per-client syntax, with explicit Codex project-level, global, and uninstall commands.
+- Clarified MCP install docs to mirror Geometra's per-client syntax, with simple Codex install first and the absolute-path command labeled as a PATH-safe fallback.
 
 ## [0.3.3] — 2026-04-25
 

README.md

@@ -217,18 +217,18 @@ Tools exposed: `store`, `retrieve`, `retrieve_brief`, `record_action`, `record_o
 <details>
 <summary>OpenAI Codex</summary>
 
-**Project-level install (recommended, one repo at a time):**
+**One-line install:**
 
 ```bash
 python3 -m pip install --upgrade "state-trace[mcp]"
-cd /path/to/your/repo
-state-trace-mcp-config --namespace "$(basename "$PWD")" > .mcp.json
+codex mcp add state-trace -- state-trace-mcp
 ```
 
-If your shell cannot find `state-trace-mcp-config`:
+**Project-level install (one repo at a time):**
 
 ```bash
-python3 -m state_trace.mcp_config --namespace "$(basename "$PWD")" > .mcp.json
+cd /path/to/your/repo
+state-trace-mcp-config --namespace "$(basename "$PWD")" > .mcp.json
 ```
 
 Or manually add to `.mcp.json` in the repo:
@@ -250,7 +250,9 @@ Or manually add to `.mcp.json` in the repo:
 
 Restart Codex after adding or changing `.mcp.json`.
 
-**Global install:**
+**PATH-safe install:**
+
+Use this if `codex mcp add state-trace -- state-trace-mcp` starts with `No such file or directory`.
 
 ```bash
 python3 -m pip install --upgrade "state-trace[mcp]"