oh-my-opencode-slim 0.4.0 → 0.5.0

package/README.md

@@ -28,6 +28,7 @@
   - [Oracle](#oracle)
   - [Librarian](#librarian)
   - [Designer](#designer)
+  - [Fixer](#fixer)
 - [🧩 **Skills**](#-skills)
   - [Available Skills](#available-skills)
   - [Default Skill Assignments](#default-skill-assignments)
@@ -62,7 +63,7 @@ bunx oh-my-opencode-slim install
 Or use non-interactive mode:
 
 ```bash
-bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=no
+bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no
 ```
 
 After installation, authenticate with your providers:
@@ -113,7 +114,11 @@ Ask these questions **one at a time**, waiting for responses:
 
 1. "Do you have an **Antigravity** subscription?" *(Provides Claude + Gemini via `google/` prefix)*
 2. "Do you have access to **OpenAI** API?" *(Enables `openai/` models)*
-3. "Do you have access to **Cerebras** API?" *(Enables `cerebras/` for fast exploration)*
+
+Help the user understand the tradeoffs:
+- Antigravity is the recommended path for Claude + Gemini routing.
+- OpenAI is optional; it enables `openai/` models.
+- If the user has **no providers**, the plugin still works using **OpenCode Zen** free models. They can switch to paid providers later by editing `~/.config/opencode/oh-my-opencode-slim.json`.
 
 ---
 
@@ -122,19 +127,19 @@ Ask these questions **one at a time**, waiting for responses:
 Based on answers, run:
 
 ```bash
-bunx oh-my-opencode-slim install --no-tui --antigravity=<yes|no> --openai=<yes|no> --cerebras=<yes|no>
+bunx oh-my-opencode-slim install --no-tui --antigravity=<yes|no> --openai=<yes|no>
 ```
 
 **Examples:**
 ```bash
 # Antigravity + OpenAI
-bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=no
+bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --tmux=no
 
 # OpenAI only
-bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=yes --cerebras=no
+bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=yes --tmux=no
 
-# All providers
-bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=yes
+# No providers (Zen free models only)
+bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=no --tmux=no
 ```
 
 The installer automatically:
@@ -143,13 +148,18 @@ The installer automatically:
 - Configures Google provider with model definitions
 - Generates agent model mappings in `~/.config/opencode/oh-my-opencode-slim.json`
 
+**Crucial Advice for the User:**
+- They can easily assign **different models to different agents** by editing `~/.config/opencode/oh-my-opencode-slim.json`.
+- If they add a new provider later, they just need to update this file.
+- Read generated  `~/.config/opencode/oh-my-opencode-slim.json` file and report the model configuration.
+
 ---
 
 #### Step 4: Authentication
 
 After installation, guide the user:
 
-**For Antigravity:**
+**For Antigravity/OpenAI:**
 ```bash
 opencode auth login
 # Select: Google → OAuth with Google (Antigravity)
@@ -166,7 +176,6 @@ bunx oh-my-opencode-slim install --help
 ```
 
 Then manually create the config files at:
-- `~/.config/opencode/opencode.json`
 - `~/.config/opencode/oh-my-opencode-slim.json`
 
 </details>
@@ -190,7 +199,21 @@ The plugin follows a "Hub and Spoke" model:
 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 performs the refactor.
+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.
 
 ---
 
@@ -221,7 +244,7 @@ Write and execute code, orchestrate multi-agent workflows, parse the unspoken fr
 > **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.
 
 **Role:** `Codebase reconnaissance`  
-**Model:** `cerebras/zai-glm-4.7`  
+**Model:** `google/gemini-3-flash`  
 **Prompt:** [src/agents/explorer.ts](src/agents/explorer.ts)
 
 Regex search, AST pattern matching, file discovery, parallel exploration. *Read-only: they chart the territory; others conquer it.*
@@ -278,6 +301,22 @@ Modern responsive design, CSS/Tailwind mastery, micro-animations, component arch
 
 ---
 
+### Fixer
+
+<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.
+
+**Role:** `Fast implementation specialist`  
+**Model:** `google/gemini-3-flash`  
+**Prompt:** [src/agents/fixer.ts](src/agents/fixer.ts)
+
+Code implementation, refactoring, testing, verification. *Execute the plan - no research, no delegation, no planning.*
+
+<br clear="both">
+
+---
+
 ## Tools & Capabilities
 
 ### Tmux Integration
@@ -397,6 +436,7 @@ Skills are specialized capabilities that agents can use. Each agent has a defaul
 | `oracle` | none |
 | `librarian` | none |
 | `explorer` | none |
+| `fixer` | none |
 
 ### YAGNI Enforcement
 
@@ -463,33 +503,63 @@ You can disable specific MCP servers by adding them to the `disabled_mcps` array
 
 ### Plugin Config (`oh-my-opencode-slim.json`)
 
-All plugin options in one file:
+The installer generates this file based on your providers. You can manually customize it to mix and match models.
+
+<details open>
+<summary><b>Example: Antigravity + OpenAI (Recommended)</b></summary>
 
 ```json
 {
+  "agents": {
+    "orchestrator": { "model": "google/claude-opus-4-5-thinking", "skills": ["*"] },
+    "oracle": { "model": "openai/gpt-5.2-codex", "skills": [] },
+    "librarian": { "model": "google/gemini-3-flash", "skills": [] },
+    "explorer": { "model": "google/gemini-3-flash", "skills": [] },
+    "designer": { "model": "google/gemini-3-flash", "skills": ["playwright"] },
+    "fixer": { "model": "google/gemini-3-flash", "skills": [] }
+  },
   "tmux": {
     "enabled": true,
     "layout": "main-vertical",
     "main_pane_size": 60
-  },
-  "disabled_agents": [],
-  "disabled_mcps": ["websearch", "grep_app"],
+  }
+}
+```
+</details>
+
+<details>
+<summary><b>Example: Antigravity Only</b></summary>
+
+```json
+{
   "agents": {
-    "orchestrator": {
-      "model": "openai/gpt-5.2-codex",
-      "variant": "high",
-      "skills": ["*"]
-    },
-    "explorer": {
-      "model": "opencode/glm-4.7",
-      "variant": "low"
-    },
-    "designer": {
-      "skills": ["playwright"]
-    }
+    "orchestrator": { "model": "google/claude-opus-4-5-thinking", "skills": ["*"] },
+    "oracle": { "model": "google/claude-opus-4-5-thinking", "skills": [] },
+    "librarian": { "model": "google/gemini-3-flash", "skills": [] },
+    "explorer": { "model": "google/gemini-3-flash", "skills": [] },
+    "designer": { "model": "google/gemini-3-flash", "skills": ["playwright"] },
+    "fixer": { "model": "google/gemini-3-flash", "skills": [] }
+  }
+}
+```
+</details>
+
+<details>
+<summary><b>Example: OpenAI Only</b></summary>
+
+```json
+{
+  "agents": {
+    "orchestrator": { "model": "openai/gpt-5.2-codex", "skills": ["*"] },
+    "oracle": { "model": "openai/gpt-5.2-codex", "skills": [] },
+    "librarian": { "model": "openai/gpt-5.1-codex-mini", "skills": [] },
+    "explorer": { "model": "openai/gpt-5.1-codex-mini", "skills": [] },
+    "designer": { "model": "openai/gpt-5.1-codex-mini", "skills": ["playwright"] },
+    "fixer": { "model": "openai/gpt-5.1-codex-mini", "skills": [] }
   }
 }
 ```
+</details>
 
 #### Option Reference
 
@@ -503,6 +573,10 @@ All plugin options in one file:
 | `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 |
 
 ---