Skip to content

AI-powered virtual executive team — a single coherent executive persona backed by 8 specialist agents (FastAPI + Next.js).

Document web search discoverability (fixes the issue behind #79)

Claudee5f93a58a6ba
diff --git a/.env.example b/.env.example
index ce47a862..46d570d9 100644
--- a/.env.example
+++ b/.env.example
@@ -129,9 +129,11 @@ HONCHO_PREFETCH_TIMEOUT_S=3.0
# OPENROUTER_REFERER=https://your-deployment.example.com
# OPENROUTER_TIMEOUT_S=180.0
-# Web search — Anthropic's native server-side web_search tool. Off by default
-# since each search is billed separately. Enable to let the Executive look up
-# live facts (market data, news, regulatory changes, competitor moves).
+# Web search — Anthropic's native server-side web_search tool. The application
+# default is ON (unset means enabled); this file ships it off so a fresh setup
+# incurs no per-search charges until you opt in. Set true to let the Executive
+# and specialists combine your uploaded documents with live lookups (market
+# data, news, regulatory changes, competitor moves).
ENABLE_WEB_SEARCH=false
WEB_SEARCH_MAX_USES=5
# Optional allowlist OR blocklist (comma-separated bare domains, no scheme).
diff --git a/README.md b/README.md
index eac870ba..432abcb8 100644
--- a/README.md
+++ b/README.md
@@ -316,6 +316,8 @@ the app refuses to start.
| `HONCHO_ENABLED` | No | `false` | Per-person memory layer ([honcho.dev](https://honcho.dev)) — a peer card shared across all channels |
| `HONCHO_API_KEY` | No | — | Required when `HONCHO_ENABLED=true` |
| `HONCHO_BASE_URL` | No | — | Self-hosted Honcho endpoint |
+| `ENABLE_WEB_SEARCH` | No | `true`² | Let the Executive and specialists answer with live web results (news, market data, competitor moves) alongside your uploaded documents |
+| `WEB_SEARCH_MAX_USES` | No | `2` | Max billed searches per agent per turn |
See [.env.example](.env.example) for the full list.
@@ -323,6 +325,14 @@ See [.env.example](.env.example) for the full list.
> It can be omitted entirely if you run on local models (`LOCAL_MODELS_ENABLED`)
> or route through OpenRouter (`OPENROUTER_ENABLED`).
+> ² The application default is on, but **[.env.example](.env.example) ships
+> `ENABLE_WEB_SEARCH=false`** so a fresh setup incurs no per-search charges —
+> if the agents tell you they can't search the web or read the news, flip it
+> to `true` in your `.env` and restart. Uses Anthropic's server-side
+> `web_search` tool, so it applies to Claude models (local models can't use
+> it). `WEB_SEARCH_ALLOWED_DOMAINS` / `WEB_SEARCH_BLOCKED_DOMAINS` scope where
+> it may look (set at most one).
+
## Running on Local Models
Open Executive can run against any **OpenAI-compatible** local server — Ollama,