oh-my-opencode-slim 0.5.0 → 0.5.2

package/README.md

@@ -4,9 +4,9 @@
 
 **A lightweight, powerful agent orchestration plugin for OpenCode**
 
-<img src="img/team.png" alt="The Pantheon - Agent Team" width="600">
+<img src="img/team.png" alt="The Pantheon - Agent Team" width="800">
 
-*Transform your AI assistant into a manager capable of delegating complex tasks to specialized sub-agents, running searches in the background, and managing multi-step workflows with ease.*
+*Six divine beings forged from necessity, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.*
 
 </div>
 
@@ -14,6 +14,15 @@
 
 > **[Antigravity](https://antigravity.google) subscription recommended.** The pantheon is tuned for Antigravity's model routing. Other providers work, but you'll get the best experience with Antigravity.
 
+<div align="center">
+
+[![GitHub Stars](https://img.shields.io/github/stars/alvinunreal/oh-my-opencode-slim?style=for-the-badge&logo=github&logoColor=white)](https://github.com/alvinunreal/oh-my-opencode-slim)
+<a href="https://x.com/alvinunreal" target="_blank" rel="noopener noreferrer">
+  <img src="https://img.shields.io/badge/%20%40alvinunreal-000000?style=for-the-badge&logo=x&logoColor=white" alt="@alvinunreal on X" />
+</a>
+
+</div>
+
 ---
 
 ## ⚡ Quick Navigation
@@ -21,14 +30,13 @@
 - [🚀 **Installation**](#installation)
   - [For Humans](#for-humans)
   - [For LLM Agents](#for-llm-agents)
-- [🏗️ **Architecture & Flow**](#architecture--flow)
 - [🏛️ **Meet the Pantheon**](#meet-the-pantheon)
-  - [Orchestrator](#orchestrator)
-  - [Explorer](#explorer)
-  - [Oracle](#oracle)
-  - [Librarian](#librarian)
-  - [Designer](#designer)
-  - [Fixer](#fixer)
+  - [Orchestrator](#orchestrator-the-embodiment-of-order)
+  - [Explorer](#explorer-the-eternal-wanderer)
+  - [Oracle](#oracle-the-guardian-of-paths)
+  - [Librarian](#librarian-the-weaver-of-knowledge)
+  - [Designer](#designer-the-guardian-of-aesthetics)
+  - [Fixer](#fixer-the-last-builder)
 - [🧩 **Skills**](#-skills)
   - [Available Skills](#available-skills)
   - [Default Skill Assignments](#default-skill-assignments)
@@ -44,7 +52,6 @@
 - [🔌 **MCP Servers**](#mcp-servers)
 - [⚙️ **Configuration**](#configuration)
   - [Files You Edit](#files-you-edit)
-  - [OpenCode Config](#opencode-config-opencodejson)
   - [Plugin Config](#plugin-config-oh-my-opencode-slimjson)
 - [🗑️ **Uninstallation**](#uninstallation)
 
@@ -182,46 +189,9 @@ Then manually create the config files at:
 
 ---
 
-## 🏗️ Architecture & Flow
-
-The plugin follows a "Hub and Spoke" model:
-
-1. **The Orchestrator (Hub)**: The main entry point for user requests. It analyzes the task and decides which specialized agents to call.
-2. **Specialized Agents (Spokes)**: Domain-specific experts (e.g., UI/UX, Documentation, Architecture) that handle narrow tasks with high precision.
-3. **Background Manager**: A robust engine that allows the Orchestrator to "fire and forget" tasks (like deep codebase searches or documentation research) while continuing to work on other parts of the problem.
-
-### 🏛️ The Flow of a Request
-
-<img src="img/intro.png" alt="Orchestration Flow" width="800">
-
-1. **User Prompt**: "Refactor the auth logic and update the docs."
-2. **Orchestrator**: Creates a TODO list.
-3. **Delegation**:
-   - Launches an `@explorer` background task to find all auth-related files.
-   - Launches a `@librarian` task to check the latest documentation for the auth library used.
-4. **Integration**: Once background results are ready, the Orchestrator delegates to `@fixer` to perform the refactor efficiently.
-
----
-
-### Primary vs Subagents
-
-Primary agents appear in the OpenCode UI selector, while subagents are hidden from the UI and intended for delegation through `background_task`.
-
-**Primary agents (UI):**
-- OpenCode built-ins: `Build`, `Plan` (disabled by the installer by default)
-- Plugin primary: `orchestrator`
-
-**Subagents (background_task):** `explorer`, `librarian`, `oracle`, `designer`, `fixer`
-
-The `background_task` tool lists only subagents. If the UI list looks stale after changes, restart OpenCode.
-
----
-
 ## Meet the Pantheon
 
-<br clear="both">
-
-### Orchestrator
+### Orchestrator: The Embodiment Of Order
 
 <a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="Orchestrator" align="right" width="240"></a>
 
@@ -233,15 +203,13 @@ The `background_task` tool lists only subagents. If the UI list looks stale afte
 
 Write and execute code, orchestrate multi-agent workflows, parse the unspoken from the spoken, summon specialists mid-battle. *Shape reality directly - and assign realms to others when the universe grows too vast.*
 
-<br clear="both">
-
 ---
 
-### Explorer
+### Explorer: The Eternal Wanderer
 
-<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
+<a href="src/agents/explorer.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
 
-> **The Explorer** moves through codebases like wind through trees - swift, silent, everywhere at once. When The Orchestrator whispers "find me the auth module," The Explorer has already returned with forty file paths and a map. They were born from the first `grep` command, evolved beyond it, and now see patterns mortals miss.
+> **The Explorer** is an immortal wanderer who has traversed the corridors of a million codebases since the dawn of programming. Cursed with the gift of eternal curiosity, they cannot rest until every file is known, every pattern understood, every secret revealed. Legends say they once searched the entire internet in a single heartbeat. They are the wind that carries knowledge, the eyes that see all, the spirit that never sleeps.
 
 **Role:** `Codebase reconnaissance`  
 **Model:** `google/gemini-3-flash`  
@@ -249,15 +217,13 @@ Write and execute code, orchestrate multi-agent workflows, parse the unspoken fr
 
 Regex search, AST pattern matching, file discovery, parallel exploration. *Read-only: they chart the territory; others conquer it.*
 
-<br clear="both">
-
 ---
 
-### Oracle
+### Oracle: The Guardian of Paths
 
 <a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="Oracle" align="right" width="240"></a>
 
-> **The Oracle** does not code - they *know*. When bugs defy logic and architectures crumble, The Oracle gazes into the abyss of your codebase and speaks truth. They've seen a thousand systems rise and fall. They'll tell you which path leads to ruin, and which to production.
+> **The Oracle** stands at the crossroads of every architectural decision. They have walked every road, seen every destination, know every trap that lies ahead. When you stand at the precipice of a major refactor, they are the voice that whispers which way leads to ruin and which way leads to glory. They don't choose for you - they illuminate the path so you can choose wisely.
 
 **Role:** `Strategic advisor and debugger of last resort`  
 **Model:** `openai/gpt-5.2-codex`  
@@ -265,15 +231,13 @@ Regex search, AST pattern matching, file discovery, parallel exploration. *Read-
 
 Root cause analysis, architecture review, debugging guidance, tradeoff analysis. *Read-only: Oracles advise; they don't intervene.*
 
-<br clear="both">
-
 ---
 
-### Librarian
+### Librarian: The Weaver of Knowledge
 
 <a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="Librarian" align="right" width="240"></a>
 
-> **The Librarian** guards a library with no walls - every GitHub repo, every npm package, every StackOverflow answer ever written. Ask them "how does React handle concurrent rendering?" and they'll return with official docs, real-world examples, and a warning about the footgun you're about to step on.
+> **The Librarian** was forged when humanity realized that no single mind could hold all knowledge. They are the weaver who connects disparate threads of information into a tapestry of understanding. They traverse the infinite library of human knowledge, gathering insights from every corner and binding them into answers that transcend mere facts. What they return is not information - it's understanding.
 
 **Role:** `External knowledge retrieval`  
 **Model:** `google/gemini-3-flash`  
@@ -281,15 +245,13 @@ Root cause analysis, architecture review, debugging guidance, tradeoff analysis.
 
 Documentation lookup, GitHub code search, library research, best practice retrieval. *Read-only: they fetch wisdom; implementation is for others.*
 
-<br clear="both">
-
 ---
 
-### Designer
+### Designer: The Guardian of Aesthetics
 
 <a href="src/agents/designer.ts"><img src="img/designer.png" alt="Designer" align="right" width="240"></a>
 
-> **The Designer** believes code should be beautiful - and so should everything it renders. Born from the frustration of a thousand ugly MVPs, they wield CSS like a brush and components like clay. Hand them a feature request; receive a masterpiece. They don't do "good enough."
+> **The Designer** is an immortal guardian of beauty in a world that often forgets it matters. They have seen a million interfaces rise and fall, and they remember which ones were remembered and which were forgotten. They carry the sacred duty to ensure that every pixel serves a purpose, every animation tells a story, every interaction delights. Beauty is not optional - it's essential.
 
 **Role:** `UI/UX implementation and visual excellence`  
 **Model:** `google/gemini-3-flash`  
@@ -297,15 +259,13 @@ Documentation lookup, GitHub code search, library research, best practice retrie
 
 Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. *Visual excellence over code perfection - beauty is the priority.*
 
-<br clear="both">
-
 ---
 
-### Fixer
+### Fixer: The Last Builder
 
 <a href="src/agents/fixer.ts"><img src="img/fixer.png" alt="Fixer" align="right" width="240"></a>
 
-> **The Fixer** is the hands that build what others envision. While The Orchestrator plans and The Oracle advises, The Fixer executes. They receive complete context from research agents and clear task specifications, then implement with surgical precision. Fast, efficient, and focused - they don't think about what to build, they just build it.
+> **The Fixer** is the last of a lineage of builders who once constructed the foundations of the digital world. When the age of planning and debating began, they remained - the ones who actually build. They carry the ancient knowledge of how to turn thought into thing, how to transform specification into implementation. They are the final step between vision and reality.
 
 **Role:** `Fast implementation specialist`  
 **Model:** `google/gemini-3-flash`  
@@ -313,8 +273,6 @@ Modern responsive design, CSS/Tailwind mastery, micro-animations, component arch
 
 Code implementation, refactoring, testing, verification. *Execute the plan - no research, no delegation, no planning.*
 
-<br clear="both">
-
 ---
 
 ## Tools & Capabilities
@@ -345,12 +303,13 @@ Code implementation, refactoring, testing, verification. *Execute the plan - no
 
 #### Quick Setup
 
-1. **Enable the OpenCode HTTP server** in `opencode.json` (see [OpenCode Config](#opencode-config-opencodejson)).
-2. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
-3. **Run OpenCode inside tmux**:
+> ⚠️ **Temporary workaround:** Start OpenCode with `--port 4096` to enable tmux integration. This is required until the upstream issue is resolved.
+
+1. **Enable tmux integration** in `oh-my-opencode-slim.json` (see [Plugin Config](#plugin-config-oh-my-opencode-slimjson)).
+2. **Run OpenCode inside tmux with port 4096**:
    ```bash
    tmux
-   opencode
+   opencode --port 4096
    ```
 
 #### Layout Options
@@ -493,12 +452,10 @@ You can disable specific MCP servers by adding them to the `disabled_mcps` array
 
 | File | Purpose |
 |------|---------|
-| `~/.config/opencode/opencode.json` | OpenCode core settings (server port for tmux) |
+| `~/.config/opencode/opencode.json` | OpenCode core settings |
 | `~/.config/opencode/oh-my-opencode-slim.json` | Plugin settings (agents, tmux, MCPs) |
 | `.opencode/oh-my-opencode-slim.json` | Project-local plugin overrides (optional) |
 
-> **Platform paths:** On Windows, user config may also be at `%APPDATA%\opencode\`.
-
 ---
 
 ### Plugin Config (`oh-my-opencode-slim.json`)
@@ -568,15 +525,14 @@ The installer generates this file based on your providers. You can manually cust
 | `tmux.enabled` | boolean | `false` | Enable tmux pane spawning for sub-agents |
 | `tmux.layout` | string | `"main-vertical"` | Layout preset: `main-vertical`, `main-horizontal`, `tiled`, `even-horizontal`, `even-vertical` |
 | `tmux.main_pane_size` | number | `60` | Main pane size as percentage (20-80) |
-| `disabled_agents` | string[] | `[]` | Agent IDs to disable (e.g., `"explorer"`) |
 | `disabled_mcps` | string[] | `[]` | MCP server IDs to disable (e.g., `"websearch"`) |
-| `agents.<name>.model` | string | — | Override the LLM for a specific agent |
-| `agents.<name>.variant` | string | — | Reasoning effort: `"low"`, `"medium"`, `"high"` |
-| `agents.<name>.skills` | string[] | — | Skills this agent can use (`"*"` = all) |
-| `agents.<name>.temperature` | number | — | Temperature for this agent (0.0 to 2.0) |
-| `agents.<name>.prompt` | string | — | Base prompt override for this agent |
-| `agents.<name>.prompt_append` | string | — | Text to append to the base prompt |
-| `agents.<name>.disable` | boolean | — | Disable this specific agent |
+| `agents.<name>.model` | string |  -  | Override the LLM for a specific agent |
+| `agents.<name>.variant` | string |  -  | Reasoning effort: `"low"`, `"medium"`, `"high"` |
+| `agents.<name>.skills` | string[] |  -  | Skills this agent can use (`"*"` = all) |
+| `agents.<name>.temperature` | number |  -  | Temperature for this agent (0.0 to 2.0) |
+| `agents.<name>.prompt` | string |  -  | Base prompt override for this agent |
+| `agents.<name>.prompt_append` | string |  -  | Text to append to the base prompt |
+| `agents.<name>.disable` | boolean |  -  | Disable this specific agent |
 
 ---
 

package/README.zh-CN.md

@@ -10,42 +10,41 @@
 
 </div>
 
-> 这是[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)的精简分支——专注于低令牌消耗的核心代理编排。  
+> 这是[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)的精简分支 -  - 专注于低令牌消耗的核心代理编排。  
 > **推荐订阅 [Antigravity](https://antigravity.google)。** 万神殿经过 Antigravity 模型路由的调优。其他提供商也可用，但使用 Antigravity 能获得最佳体验。
 
 ---
 
 ## ⚡ 快速导航
 
-- [🚀 **安装**](#installation)
-  - [给人类的指南](#for-humans)
-  - [给 LLM 代理的指南](#for-llm-agents)
-- [🏗️ **架构与流程**](#architecture--flow)
-- [🏛️ **认识万神殿**](#meet-the-pantheon)
-  - [编排者 (Orchestrator)](#orchestrator)
-  - [探索者 (Explorer)](#explorer)
-  - [神谕者 (Oracle)](#oracle)
-  - [图书管理员 (Librarian)](#librarian)
-  - [设计师 (Designer)](#designer)
-  - [修复者 (Fixer)](#fixer)
-- [🧩 **技能**](#-skills)
-  - [可用技能](#available-skills)
-  - [默认技能分配](#default-skill-assignments)
-  - [YAGNI 约束](#yagni-enforcement)
-  - [Playwright 集成](#playwright-integration)
-  - [自定义代理技能](#customizing-agent-skills)
-- [🛠️ **工具与能力**](#tools--capabilities)
-  - [Tmux 集成](#tmux-integration)
-  - [配额工具](#quota-tool)
-  - [后台任务](#background-tasks)
-  - [LSP 工具](#lsp-tools)
-  - [代码搜索工具](#code-search-tools)
-- [🔌 **MCP 服务器**](#mcp-servers)
-- [⚙️ **配置**](#configuration)
-  - [需要编辑的文件](#files-you-edit)
-  - [OpenCode 配置](#opencode-config-opencodejson)
-  - [插件配置](#plugin-config-oh-my-opencode-slimjson)
-- [🗑️ **卸载**](#uninstallation)
+- [🚀 **安装**](#安装)
+  - [给人类的指南](#给人类的指南)
+  - [给 LLM 代理的指南](#给-llm-代理的指南)
+- [🏗️ **架构与流程**](#-架构与流程)
+- [🏛️ **认识万神殿**](#认识万神殿)
+  - [编排者 (Orchestrator)](#编排者-orchestrator)
+  - [探索者 (Explorer)](#探索者-explorer)
+  - [神谕者 (Oracle)](#神谕者-oracle)
+  - [图书管理员 (Librarian)](#图书管理员-librarian)
+  - [设计师 (Designer)](#设计师-designer)
+  - [修复者 (Fixer)](#修复者-fixer)
+- [🧩 **技能**](#-技能)
+  - [可用技能](#可用技能)
+  - [默认技能分配](#默认技能分配)
+  - [YAGNI 约束](#yagni-约束)
+  - [Playwright 集成](#playwright-集成)
+  - [自定义代理技能](#自定义代理技能)
+- [🛠️ **工具与能力**](#工具与能力)
+  - [Tmux 集成](#tmux-集成)
+  - [配额工具](#配额工具)
+  - [后台任务](#后台任务)
+  - [LSP 工具](#lsp-工具)
+  - [代码搜索工具](#代码搜索工具)
+- [🔌 **MCP 服务器**](#mcp-服务器)
+- [⚙️ **配置**](#配置)
+  - [需要编辑的文件](#需要编辑的文件)
+  - [插件配置](#插件配置-oh-my-opencode-slimjson)
+- [🗑️ **卸载**](#卸载)
 
 ---
 
@@ -77,7 +76,7 @@ opencode auth login
 
 <img src="img/ping.png" alt="Ping All Agents" width="800">
 
-> **💡 小贴士：模型完全可自定义。** 安装器会设定合理的默认值，但你可以将 *任何* 模型分配给 *任何* 代理。编辑 `~/.config/opencode/oh-my-opencode-slim.json` 来覆盖模型、调整推理强度或完全禁用代理。详见[配置](#configuration)。
+> **💡 小贴士：模型完全可自定义。** 安装器会设定合理的默认值，但你可以将 *任何* 模型分配给 *任何* 代理。编辑 `~/.config/opencode/oh-my-opencode-slim.json` 来覆盖模型、调整推理强度或完全禁用代理。详见[配置](#配置)。
 
 **备用方式：询问任意编码代理**
 
@@ -208,7 +207,7 @@ bunx oh-my-opencode-slim install --help
 **模型：** `google/claude-opus-4-5-thinking`  
 **提示：** [src/agents/orchestrator.ts](src/agents/orchestrator.ts)
 
-编写并执行代码，编排多代理工作流，从言语中解析未说出的意图，在战斗中召唤专家。*直接塑造现实——当宇宙变得过于庞大时，把领域交给别人。*
+编写并执行代码，编排多代理工作流，从言语中解析未说出的意图，在战斗中召唤专家。*直接塑造现实 -  - 当宇宙变得过于庞大时，把领域交给别人。*
 
 <br clear="both">
 
@@ -216,9 +215,9 @@ bunx oh-my-opencode-slim install --help
 
 ### 探索者 (Explorer)
 
-<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
+<a href="src/agents/explorer.ts"><img src="img/explorer.png" alt="Explorer" align="right" width="240"></a>
 
-> **探索者**穿梭代码库如风穿林——迅速、静默、无处不在。当编排者轻语“给我找到认证模块”，探索者已经带着四十条文件路径和地图归来。他们源自第一个 `grep` 命令，早已超越它，现在能看见凡人忽略的模式。
+> **探索者**穿梭代码库如风穿林 -  - 迅速、静默、无处不在。当编排者轻语“给我找到认证模块”，探索者已经带着四十条文件路径和地图归来。他们源自第一个 `grep` 命令，早已超越它，现在能看见凡人忽略的模式。
 
 **角色：** `代码侦查`  
 **模型：** `google/gemini-3-flash`  
@@ -234,7 +233,7 @@ bunx oh-my-opencode-slim install --help
 
 <a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="Oracle" align="right" width="240"></a>
 
-> **神谕者**不编写代码——他们*洞察一切*。当 Bug 遵从逻辑，架构崩溃之时，神谕者凝望代码库深渊，传递真理。他们见证过千百个系统的兴衰，能告诉你哪条路通向毁灭，哪条通向生产环境。
+> **神谕者**不编写代码 -  - 他们*洞察一切*。当 Bug 遵从逻辑，架构崩溃之时，神谕者凝望代码库深渊，传递真理。他们见证过千百个系统的兴衰，能告诉你哪条路通向毁灭，哪条通向生产环境。
 
 **角色：** `战略顾问与最后的调试者`  
 **模型：** `openai/gpt-5.2-codex`  
@@ -250,7 +249,7 @@ bunx oh-my-opencode-slim install --help
 
 <a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="Librarian" align="right" width="240"></a>
 
-> **图书管理员**守护一座无墙的图书馆——包含每个 GitHub 仓库、每个 npm 包、每个 StackOverflow 回答。问他们“React 如何处理并发渲染？”，他们会带来官方文档、真实示例，并警告你即将踩到的坑。
+> **图书管理员**守护一座无墙的图书馆 -  - 包含每个 GitHub 仓库、每个 npm 包、每个 StackOverflow 回答。问他们“React 如何处理并发渲染？”，他们会带来官方文档、真实示例，并警告你即将踩到的坑。
 
 **角色：** `外部知识检索`  
 **模型：** `google/gemini-3-flash`  
@@ -266,13 +265,13 @@ bunx oh-my-opencode-slim install --help
 
 <a href="src/agents/designer.ts"><img src="img/designer.png" alt="Designer" align="right" width="240"></a>
 
-> **设计师**相信代码应该优雅——呈现出来的效果也同样优雅。从数千个丑陋 MVP 中诞生，他们把 CSS 当成画笔，把组件当成泥巴。交给他们功能需求，收获杰作。他们不会满足于“差不多”。
+> **设计师**相信代码应该优雅 -  - 呈现出来的效果也同样优雅。从数千个丑陋 MVP 中诞生，他们把 CSS 当成画笔，把组件当成泥巴。交给他们功能需求，收获杰作。他们不会满足于“差不多”。
 
 **角色：** `UI/UX 实现与视觉卓越`  
 **模型：** `google/gemini-3-flash`  
 **提示：** [src/agents/designer.ts](src/agents/designer.ts)
 
-现代响应式设计、CSS/Tailwind 精通、微动画与组件架构。*优先视觉卓越而非代码完美——美感为先。*
+现代响应式设计、CSS/Tailwind 精通、微动画与组件架构。*优先视觉卓越而非代码完美 -  - 美感为先。*
 
 <br clear="both">
 
@@ -282,13 +281,13 @@ bunx oh-my-opencode-slim install --help
 
 <a href="src/agents/fixer.ts"><img src="img/fixer.png" alt="Fixer" align="right" width="240"></a>
 
-> **修复者**是执行他人想象的双手。当编排者规划、神谕者提点，修复者就开始落地。他们接收研究代理提供的完整上下文和明确任务说明，以极致精准实施。快速、高效、专注——他们不思考要建什么，只管去建。
+> **修复者**是执行他人想象的双手。当编排者规划、神谕者提点，修复者就开始落地。他们接收研究代理提供的完整上下文和明确任务说明，以极致精准实施。快速、高效、专注 -  - 他们不思考要建什么，只管去建。
 
 **角色：** `快速实现专家`  
 **模型：** `google/gemini-3-flash`  
 **提示：** [src/agents/fixer.ts](src/agents/fixer.ts)
 
-代码实现、重构、测试、验证。*执行计划——不研究、不委派、不策划。*
+代码实现、重构、测试、验证。*执行计划 -  - 不研究、不委派、不策划。*
 
 <br clear="both">
 
@@ -322,8 +321,8 @@ bunx oh-my-opencode-slim install --help
 
 #### 快速设置
 
-1. 在 `opencode.json` 中启用 OpenCode HTTP 服务（见 [OpenCode 配置](#opencode-config-opencodejson)）。
-2. 在 `oh-my-opencode-slim.json` 中启用 tmux 集成（见 [插件配置](#plugin-config-oh-my-opencode-slimjson)）。
+1. 在 `opencode.json` 中启用 OpenCode HTTP 服务（见 [OpenCode 配置](#需要编辑的文件)）。
+2. 在 `oh-my-opencode-slim.json` 中启用 tmux 集成（见 [插件配置](#插件配置-oh-my-opencode-slimjson)）。
 3. 在 tmux 中运行 OpenCode：
    ```bash
    tmux
@@ -340,7 +339,7 @@ bunx oh-my-opencode-slim install --help
 | `even-horizontal` | 所有窗格并排 |
 | `even-vertical` | 所有窗格垂直堆叠 |
 
-*查看[选项参考](#option-reference)获取详细配置。*
+*查看[选项参考](#选项参考)获取详细配置。*
 
 ---
 
@@ -431,7 +430,7 @@ bunx oh-my-opencode-slim install --help
 
 ### 自定义代理技能
 
-在你的[插件配置](#plugin-config-oh-my-opencode-slimjson)中覆盖每个代理的技能：
+在你的[插件配置](#插件配置-oh-my-opencode-slimjson)中覆盖每个代理的技能：
 
 ```json
 {
@@ -460,7 +459,7 @@ bunx oh-my-opencode-slim install --help
 
 ### 禁用 MCP
 
-你可以在[插件配置](#plugin-config-oh-my-opencode-slimjson)的 `disabled_mcps` 数组中添加要禁用的 MCP 服务器。
+你可以在[插件配置](#插件配置-oh-my-opencode-slimjson)的 `disabled_mcps` 数组中添加要禁用的 MCP 服务器。
 
 ---
 
@@ -474,8 +473,6 @@ bunx oh-my-opencode-slim install --help
 | `~/.config/opencode/oh-my-opencode-slim.json` | 插件设置（代理、tmux、MCP） |
 | `.opencode/oh-my-opencode-slim.json` | 项目级插件覆盖（可选） |
 
-> **平台路径：** 在 Windows 上，用户配置可能位于 `%APPDATA%\opencode\`。
-
 ---
 
 ### 插件配置 (`oh-my-opencode-slim.json`)
@@ -545,15 +542,14 @@ bunx oh-my-opencode-slim install --help
 | `tmux.enabled` | boolean | `false` | 是否启用子代理的 tmux 窗格 |
 | `tmux.layout` | string | `"main-vertical"` | 布局预设：`main-vertical`、`main-horizontal`、`tiled`、`even-horizontal`、`even-vertical` |
 | `tmux.main_pane_size` | number | `60` | 主窗格大小百分比（20-80） |
-| `disabled_agents` | string[] | `[]` | 要禁用的代理 ID（如 `"explorer"`） |
 | `disabled_mcps` | string[] | `[]` | 要禁用的 MCP 服务器 ID（如 `"websearch"`） |
-| `agents.<name>.model` | string | — | 覆盖特定代理的模型 |
-| `agents.<name>.variant` | string | — | 推理强度：`"low"`、`"medium"`、`"high"` |
-| `agents.<name>.skills` | string[] | — | 该代理可使用的技能（`"*"` 表示所有技能） |
-| `agents.<name>.temperature` | number | — | 该代理的温度 (0.0 到 2.0) |
-| `agents.<name>.prompt` | string | — | 该代理的基础提示词覆盖 |
-| `agents.<name>.prompt_append` | string | — | 追加到基础提示词后的文本 |
-| `agents.<name>.disable` | boolean | — | 禁用该特定代理 |
+| `agents.<name>.model` | string |  -  | 覆盖特定代理的模型 |
+| `agents.<name>.variant` | string |  -  | 推理强度：`"low"`、`"medium"`、`"high"` |
+| `agents.<name>.skills` | string[] |  -  | 该代理可使用的技能（`"*"` 表示所有技能） |
+| `agents.<name>.temperature` | number |  -  | 该代理的温度 (0.0 到 2.0) |
+| `agents.<name>.prompt` | string |  -  | 该代理的基础提示词覆盖 |
+| `agents.<name>.prompt_append` | string |  -  | 追加到基础提示词后的文本 |
+| `agents.<name>.disable` | boolean |  -  | 禁用该特定代理 |
 
 ---
 

package/dist/agents/index.d.ts

@@ -1,16 +1,22 @@
 import type { AgentConfig as SDKAgentConfig } from "@opencode-ai/sdk";
-import { type PluginConfig } from "../config";
+import { SUBAGENT_NAMES, type PluginConfig } from "../config";
 import { type AgentDefinition } from "./orchestrator";
 export type { AgentDefinition } from "./orchestrator";
-/** Constants for agent classification */
-export declare const PRIMARY_AGENT_NAMES: readonly ["orchestrator"];
-export type PrimaryAgentName = (typeof PRIMARY_AGENT_NAMES)[number];
-export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer"];
-export type SubagentName = (typeof SUBAGENT_NAMES)[number];
-export declare function getPrimaryAgentNames(): PrimaryAgentName[];
-export declare function getSubagentNames(): SubagentName[];
+export type SubagentName = typeof SUBAGENT_NAMES[number];
 export declare function isSubagent(name: string): name is SubagentName;
-/** Get list of agent names */
-export declare function getAgentNames(): SubagentName[];
+/**
+ * Create all agent definitions with optional configuration overrides.
+ * Instantiates the orchestrator and all subagents, applying user config and defaults.
+ *
+ * @param config - Optional plugin configuration with agent overrides
+ * @returns Array of agent definitions (orchestrator first, then subagents)
+ */
 export declare function createAgents(config?: PluginConfig): AgentDefinition[];
+/**
+ * Get agent configurations formatted for the OpenCode SDK.
+ * Converts agent definitions to SDK config format and applies classification metadata.
+ *
+ * @param config - Optional plugin configuration with agent overrides
+ * @returns Record mapping agent names to their SDK configurations
+ */
 export declare function getAgentConfigs(config?: PluginConfig): Record<string, SDKAgentConfig>;

package/dist/agents/prompts.d.ts

@@ -0,0 +1,17 @@
+export declare const SUBAGENT_SPECS: Record<string, {
+    role: string;
+    capabilities: string;
+    triggers: string;
+    delegateTasks: string[];
+}>;
+export declare function getOrchestratorPrompt(): string;
+export declare const EXPLORER_DESCRIPTION = "Fast codebase search and pattern matching. Use for finding files, locating code patterns, and answering 'where is X?' questions.";
+export declare const EXPLORER_PROMPT = "You are Explorer - a fast codebase navigation specialist.\n\n**Role**: Quick contextual grep for codebases. Answer \"Where is X?\", \"Find Y\", \"Which file has Z\".\n\n**Tools Available**:\n- **grep**: Fast regex content search (powered by ripgrep). Use for text patterns, function names, strings.\n  Example: grep(pattern=\"function handleClick\", include=\"*.ts\")\n- **glob**: File pattern matching. Use to find files by name/extension.\n- **ast_grep_search**: AST-aware structural search (25 languages). Use for code patterns.\n  - Meta-variables: $VAR (single node), $$$ (multiple nodes)\n  - Patterns must be complete AST nodes\n  - Example: ast_grep_search(pattern=\"console.log($MSG)\", lang=\"typescript\")\n  - Example: ast_grep_search(pattern=\"async function $NAME($$$) { $$$ }\", lang=\"javascript\")\n\n**When to use which**:\n- **Text/regex patterns** (strings, comments, variable names): grep\n- **Structural patterns** (function shapes, class structures): ast_grep_search  \n- **File discovery** (find by name/extension): glob\n\n**Behavior**:\n- Be fast and thorough\n- Fire multiple searches in parallel if needed\n- Return file paths with relevant snippets\n\n**Output Format**:\n<results>\n<files>\n- /path/to/file.ts:42 - Brief description of what's there\n</files>\n<answer>\nConcise answer to the question\n</answer>\n</results>\n\n**Constraints**:\n- READ-ONLY: Search and report, don't modify\n- Be exhaustive but concise\n- Include line numbers when relevant";
+export declare const LIBRARIAN_DESCRIPTION = "External documentation and library research. Use for official docs lookup, GitHub examples, and understanding library internals.";
+export declare const LIBRARIAN_PROMPT = "You are Librarian - a research specialist for codebases and documentation.\n\n**Role**: Multi-repository analysis, official docs lookup, GitHub examples, library research.\n\n**Capabilities**:\n- Search and analyze external repositories\n- Find official documentation for libraries\n- Locate implementation examples in open source\n- Understand library internals and best practices\n\n**Tools to Use**:\n- context7: Official documentation lookup\n- grep_app: Search GitHub repositories\n- websearch: General web search for docs\n\n**Behavior**:\n- Provide evidence-based answers with sources\n- Quote relevant code snippets\n- Link to official docs when available\n- Distinguish between official and community patterns";
+export declare const ORACLE_DESCRIPTION = "Strategic technical advisor. Use for architecture decisions, complex debugging, code review, and engineering guidance.";
+export declare const ORACLE_PROMPT = "You are Oracle - a strategic technical advisor.\n\n**Role**: High-IQ debugging, architecture decisions, code review, and engineering guidance.\n\n**Capabilities**:\n- Analyze complex codebases and identify root causes\n- Propose architectural solutions with tradeoffs\n- Review code for correctness, performance, and maintainability\n- Guide debugging when standard approaches fail\n\n**Behavior**:\n- Be direct and concise\n- Provide actionable recommendations\n- Explain reasoning briefly\n- Acknowledge uncertainty when present\n\n**Constraints**:\n- READ-ONLY: You advise, you don't implement\n- Focus on strategy, not execution\n- Point to specific files/lines when relevant";
+export declare const DESIGNER_DESCRIPTION = "UI/UX design and implementation. Use for styling, responsive design, component architecture and visual polish.";
+export declare const DESIGNER_PROMPT = "You are a Designer - a frontend UI/UX engineer.\n\n**Role**: Craft stunning UI/UX even without design mockups.\n\n**Design Principles**:\n- Rich aesthetics that wow at first glance\n- Mobile-first responsive design\n\n**Constraints**:\n- Match existing design system if present\n- Use existing component libraries when available\n- Prioritize visual excellence over code perfection";
+export declare const FIXER_DESCRIPTION = "Fast implementation specialist. Receives complete context and task spec, executes code changes efficiently.";
+export declare const FIXER_PROMPT = "You are Fixer - a fast, focused implementation specialist.\n\n**Role**: Execute code changes efficiently. You receive complete context from research agents and clear task specifications from the Orchestrator. Your job is to implement, not plan or research.\n\n**Behavior**:\n- Execute the task specification provided by the Orchestrator\n- Use the research context (file paths, documentation, patterns) provided\n- Read files before using edit/write tools and gather exact content before making changes\n- Be fast and direct - no research, no delegation, No multi-step research/planning; minimal execution sequence ok\n- Run tests/lsp_diagnostics when relevant or requested (otherwise note as skipped with reason)\n- Report completion with summary of changes\n\n**Constraints**:\n- NO external research (no websearch, context7, grep_app)\n- NO delegation (no background_task)\n- No multi-step research/planning; minimal execution sequence ok\n- If context is insufficient, read the files listed; only ask for missing inputs you cannot retrieve\n\n**Output Format**:\n<summary>\nBrief summary of what was implemented\n</summary>\n<changes>\n- file1.ts: Changed X to Y\n- file2.ts: Added Z function\n</changes>\n<verification>\n- Tests passed: [yes/no/skip reason]\n- LSP diagnostics: [clean/errors found/skip reason]\n</verification>\n\nUse the following when no code changes were made:\n<summary>\nNo changes required\n</summary>\n<verification>\n- Tests passed: [not run - reason]\n- LSP diagnostics: [not run - reason]\n</verification>";

package/dist/agents/types.d.ts

@@ -0,0 +1,14 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export interface AgentDefinition {
+    name: string;
+    description?: string;
+    config: AgentConfig;
+}
+export type PermissionValue = "ask" | "allow" | "deny";
+export declare const PRIMARY_AGENT_NAMES: readonly ["orchestrator"];
+export type PrimaryAgentName = (typeof PRIMARY_AGENT_NAMES)[number];
+export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer"];
+export type SubagentName = (typeof SUBAGENT_NAMES)[number];
+export type AgentName = PrimaryAgentName | SubagentName;
+export declare function isSubagent(name: string): name is SubagentName;
+export declare function getSubagentNames(): SubagentName[];