docs: added instructions for enabling web-search manually for codex

docs/getting-started.md

@@ -147,6 +147,15 @@ PATH = "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:$HOME/.local/bin:$HOME/.c
 GEMINI_API_KEY = "your_api_key_here"
 ```
 
+Enable Codex's built-in web-search tool so Zen's `apilookup` instructions can execute successfully:
+
+```toml
+[tools]
+web_search = true
+```
+
+Add the block above if `[tools]` is missing from the file; otherwise ensure `web_search = true` appears in that section.
+
 
 **For Qwen Code CLI:**
 Create or edit `~/.qwen/settings.json`:

docs/tools/apilookup.md

@@ -95,3 +95,14 @@ The tool returns JSON with:
 - `user_prompt`: Your original request
 
 The AI then performs the actual web searches and synthesizes the results into actionable documentation.
+
+## Codex CLI Configuration Reminder
+
+If you use Zen through the Codex CLI, the assistant needs Codex's native web-search tool to fetch current documentation. After adding the Zen MCP entry to `~/.codex/config.toml`, confirm the file also contains:
+
+```toml
+[tools]
+web_search = true
+```
+
+If `[tools]` is missing, append the block manually. Without this flag, `apilookup` will keep requesting web searches that Codex cannot execute, and you'll see repeated attempts at using `curl` incorrectly.