diff --git a/README.md b/README.md
index a4f530d..52eabd9 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ echo 'export BRAVE_API_KEY=BSA...' >> ~/.bashrc
 
 ## What's Synced
 
-- **9 Plugins** - oh-my-openagent, opencode-mem, opencode-pty, dynamic context pruning, RAG, command-inject, notify, agent-identity, tokenscope
+- **8 Plugins** - oh-my-openagent, opencode-mem, opencode-pty, dynamic context pruning, command-inject, notify, agent-identity, tokenscope
 - **32 Skills** - Coding standards, frontend/backend patterns, security review, etc.
 - **3 Agents** - explorer, reviewer, docs-researcher
 - **14 MCP Servers** - codegraph, brave-search, playwright, github, context7, exa, etc.
@@ -100,6 +100,15 @@ git pull
 **Git MCP fails?**
 - Install Python package: `pip install mcp-server-git`
 
+**opencode hangs on startup (no output)?**
+- The `opencode-rag-plugin` was removed because its startup probes a local
+  embedding backend (Ollama on `localhost:11434` by default) with no timeout —
+  if Ollama isn't running, opencode hangs after loading plugins.
+- To re-enable it, first start a backend (`ollama serve` + `ollama pull embeddinggemma`,
+  or configure an OpenAI/Cohere embedding key), then add `"opencode-rag-plugin"`
+  back to the `plugin` array in `opencode.json.template`.
+- Diagnose plugin hangs with `opencode run --pure "ok"` (runs without external plugins).
+
 ## Structure
 
 ```
diff --git a/opencode.json.template b/opencode.json.template
index 2e6db46..d42dfc7 100644
--- a/opencode.json.template
+++ b/opencode.json.template
@@ -96,7 +96,6 @@
     "opencode-mem",
     "opencode-pty",
     "@tarquinen/opencode-dcp",
-    "opencode-rag-plugin",
     "opencode-command-inject",
     "opencode-notify",
     "@gotgenes/opencode-agent-identity",