From e748e9c93ff263d7f8f3df34904d13ccaf091df5 Mon Sep 17 00:00:00 2001 From: chaos Date: Mon, 15 Jun 2026 23:07:38 +0800 Subject: [PATCH] Remove opencode-rag-plugin: hangs startup without Ollama embedding backend The RAG plugin probes a local embedding backend (Ollama on localhost:11434 by default) at init with no timeout. When Ollama isn't running, opencode hangs after loading plugins and never starts. Dropped it from the template and documented re-enable steps + the --pure diagnostic in the README. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 11 ++++++++++- opencode.json.template | 1 - 2 files changed, 10 insertions(+), 2 deletions(-) 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",