From ba348e34d623213d9e70c2bfb1ff37b1b8573b61 Mon Sep 17 00:00:00 2001
From: Fahad <fahad@2doapp.com>
Date: Mon, 6 Oct 2025 11:20:46 +0400
Subject: [PATCH] docs: added instructions for enabling web-search manually for
 codex

---
 docs/getting-started.md |  9 +++++++++
 docs/tools/apilookup.md | 11 +++++++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/getting-started.md b/docs/getting-started.md
index 5627cce..6be991d 100644
--- a/docs/getting-started.md
+++ b/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`:
diff --git a/docs/tools/apilookup.md b/docs/tools/apilookup.md
index 47fe1ca..4571c7f 100644
--- a/docs/tools/apilookup.md
+++ b/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.