oh-my-opencode-slim 0.3.6 → 0.4.0

package/README.md

@@ -10,9 +10,9 @@
 
 </div>
 
-> Slimmed-down fork of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - focused on core agent orchestration without the extra bells and whistles.
+> Slimmed-down fork of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - focused on core agent orchestration with low token consumption.
 
-> **[Antigravity](https://antigravity.ai) subscription recommended.** The pantheon is tuned for Antigravity's model routing. Other providers work, but you'll get the best experience with Antigravity.
+> **[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.
 
 ---
 
@@ -27,20 +27,24 @@
   - [Explorer](#explorer)
   - [Oracle](#oracle)
   - [Librarian](#librarian)
-  - [Frontend Designer](#frontend-designer)
-  - [Document Writer](#document-writer)
-  - [Multimodal Viewer](#multimodal-viewer)
-  - [Code Simplifier](#code-simplifier)
+  - [Designer](#designer)
+- [🧩 **Skills**](#-skills)
+  - [Available Skills](#available-skills)
+  - [Default Skill Assignments](#default-skill-assignments)
+  - [YAGNI Enforcement](#yagni-enforcement)
+  - [Playwright Integration](#playwright-integration)
+  - [Customizing Agent Skills](#customizing-agent-skills)
 - [🛠️ **Tools & Capabilities**](#tools--capabilities)
   - [Tmux Integration](#tmux-integration)
   - [Quota Tool](#quota-tool)
   - [Background Tasks](#background-tasks)
   - [LSP Tools](#lsp-tools)
   - [Code Search Tools](#code-search-tools)
-- [🧩 **Skills**](#-skills)
-  - [Playwright Integration](#playwright-integration)
 - [🔌 **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)
 
 ---
@@ -61,6 +65,20 @@ Or use non-interactive mode:
 bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=no
 ```
 
+After installation, authenticate with your providers:
+
+```bash
+opencode auth login
+# Select your provider → Complete OAuth flow
+# Repeat for each provider you enabled
+```
+
+Once authenticated, run opencode and `ping all agents` to verify all agents respond.
+
+<img src="img/ping.png" alt="Ping All Agents" width="800">
+
+> **💡 Tip: Models are fully customizable.** The installer sets sensible defaults, but you can assign *any* model to *any* agent. Edit `~/.config/opencode/oh-my-opencode-slim.json` to override models, adjust reasoning effort, or disable agents entirely. See [Configuration](#configuration) for details.
+
 **Alternative: Ask any coding agent**
 
 Paste this into Claude Code, AmpCode, Cursor, or any coding agent:
@@ -135,24 +153,7 @@ After installation, guide the user:
 ```bash
 opencode auth login
 # Select: Google → OAuth with Google (Antigravity)
-```
-
-**For OpenAI:**
-```bash
-export OPENAI_API_KEY="sk-..."
-```
-
-**For Cerebras:**
-```bash
-export CEREBRAS_API_KEY="..."
-```
-
----
-
-#### Step 5: Verify
-
-```bash
-opencode
+# Repeat for all other providers
 ```
 
 ---
@@ -187,10 +188,9 @@ The plugin follows a "Hub and Spoke" model:
 1. **User Prompt**: "Refactor the auth logic and update the docs."
 2. **Orchestrator**: Creates a TODO list.
 3. **Delegation**:
-   - Launches an `@explore` background task to find all auth-related files.
+   - 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.
-5. **Finalization**: Passes the changes to `@document-writer` to update the README.
 
 ---
 
@@ -221,8 +221,8 @@ 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.6`  
-**Prompt:** [src/agents/explore.ts](src/agents/explore.ts)
+**Model:** `cerebras/zai-glm-4.7`  
+**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.*
 
@@ -262,15 +262,15 @@ Documentation lookup, GitHub code search, library research, best practice retrie
 
 ---
 
-### Frontend Designer
+### Designer
 
-<a href="src/agents/frontend.ts"><img src="img/designer.png" alt="Frontend Designer" align="right" width="240"></a>
+<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."
 
 **Role:** `UI/UX implementation and visual excellence`  
 **Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/frontend.ts](src/agents/frontend.ts)
+**Prompt:** [src/agents/designer.ts](src/agents/designer.ts)
 
 Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. *Visual excellence over code perfection - beauty is the priority.*
 
@@ -278,58 +278,12 @@ Modern responsive design, CSS/Tailwind mastery, micro-animations, component arch
 
 ---
 
-### Document Writer
-
-<a href="src/agents/document-writer.ts"><img src="img/scribe.png" alt="Document Writer" align="right" width="240"></a>
-
-> **The Scribe** was there when the first README was written - and wept, for it was incomplete. They have devoted eternity to the sacred art of documentation: clear, scannable, honest. While others ship features, The Scribe ensures those features are understood. Every code example works. Every explanation enlightens.
-
-**Role:** `Technical documentation and knowledge capture`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/document-writer.ts](src/agents/document-writer.ts)
-
-README crafting, API documentation, architecture docs, inline comments that don't insult your intelligence. *Match existing style; focus on "why," not just "what."*
-
-<br clear="both">
-
----
-
-### Multimodal Viewer
-
-<a href="src/agents/multimodal.ts"><img src="img/multimodal.png" alt="Multimodal Viewer" align="right" width="240"></a>
-
-> **The Visionary** sees what others cannot - literally. Screenshots, wireframes, diagrams, PDFs: all are text to them. When a designer throws a Figma mockup at the team and vanishes, The Visionary translates vision into specification. They read the unreadable and describe the indescribable.
-
-**Role:** `Image and visual content analysis`  
-**Model:** `google/gemini-3-flash`  
-**Prompt:** [src/agents/multimodal.ts](src/agents/multimodal.ts)
-
-Extract text from images, interpret diagrams, analyze UI screenshots, summarize visual documents. *Report what they observe; inference is for others.*
-
-<br clear="both">
-
----
-
-### Code Simplifier
-
-<a href="src/agents/simplicity-reviewer.ts"><img src="img/code-simplicity.png" alt="Code Simplifier" align="right" width="240"></a>
-
-> **The Minimalist** has one sacred truth: every line of code is a liability. They hunt abstractions that serve no purpose, defensive checks that defend nothing, and "clever" solutions that will haunt you in six months. Where others add, The Minimalist subtracts - ruthlessly, joyfully, necessarily.
-
-**Role:** `Code simplification and YAGNI enforcement`  
-**Model:** `google/claude-opus-4-5-thinking`  
-**Prompt:** [src/agents/simplicity-reviewer.ts](src/agents/simplicity-reviewer.ts)
-
-Identify unnecessary complexity, challenge premature abstractions, estimate LOC reduction, enforce minimalism. *Read-only: they judge; The Orchestrator executes the sentence.*
-
-<br clear="both">
-
----
-
 ## Tools & Capabilities
 
 ### Tmux Integration
 
+> ⚠️ **Known Issue:** When the server port is enabled, only one OpenCode instance can be opened at a time. We're tracking this in [issue #15](https://github.com/alvinunreal/oh-my-opencode-slim/issues/15), and there's an upstream PR to OpenCode: [opencode#9099](https://github.com/anomalyco/opencode/issues/9099).
+
 <img src="img/tmux.png" alt="Tmux Integration" width="800">
 
 **Watch your agents work in real-time.** When the Orchestrator launches sub-agents or initiates background tasks, new tmux panes automatically spawn showing each agent's live progress. No more waiting in the dark.
@@ -352,40 +306,13 @@ Identify unnecessary complexity, challenge premature abstractions, estimate LOC
 
 #### Quick Setup
 
-**1. Enable the OpenCode HTTP server** (one-time setup)
-
-Add to your `~/.config/opencode/opencode.json`:
-
-```json
-{
-  "server": {
-    "port": 4096
-  }
-}
-```
-
-**2. Enable tmux integration in the plugin**
-
-Add to your `~/.config/opencode/oh-my-opencode-slim.json`:
-
-```json
-{
-  "tmux": {
-    "enabled": true,
-    "layout": "main-vertical",
-    "main_pane_size": 60
-  }
-}
-```
-
-**3. Run OpenCode inside tmux**
-
-```bash
-tmux
-opencode
-```
-
-That's it. When agents spawn, they'll appear in new panes.
+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**:
+   ```bash
+   tmux
+   opencode
+   ```
 
 #### Layout Options
 
@@ -397,23 +324,7 @@ That's it. When agents spawn, they'll appear in new panes.
 | `even-horizontal` | All panes side by side |
 | `even-vertical` | All panes stacked vertically |
 
-#### Configuration Reference
-
-```json
-{
-  "tmux": {
-    "enabled": true,
-    "layout": "main-vertical",
-    "main_pane_size": 60
-  }
-}
-```
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `enabled` | boolean | `false` | Enable/disable tmux integration |
-| `layout` | string | `"main-vertical"` | Tmux layout preset |
-| `main_pane_size` | number | `60` | Size of main pane as percentage (20-80) |
+*See the [Option Reference](#option-reference) for detailed configuration.*
 
 ---
 
@@ -431,7 +342,6 @@ For Antigravity users. You can trigger this at any time by asking the agent to *
 
 ### Background Tasks
 
-
 The plugin provides tools to manage asynchronous work:
 
 | Tool | Description |
@@ -469,21 +379,55 @@ Fast code search and refactoring:
 
 ## 🧩 Skills
 
-Skills are specialized capabilities that combine MCP servers with specific instructions for the Orchestrator.
+Skills are specialized capabilities that agents can use. Each agent has a default set of skills, which you can override in the agent config.
 
-### Playwright Integration
+### Available Skills
 
-**The Orchestrator's eyes and hands in the browser.**
+| Skill | Description |
+|-------|-------------|
+| `yagni-enforcement` | Code complexity analysis and YAGNI enforcement |
+| `playwright` | Browser automation via Playwright MCP |
 
-| Tool | Description |
-|------|-------------|
-| `omo_skill` | Loads a skill (e.g., `playwright`) and provides its instructions and available MCP tools |
-| `omo_skill_mcp` | Invokes a specific tool from an MCP server managed by a skill |
+### Default Skill Assignments
+
+| Agent | Default Skills |
+|-------|----------------|
+| `orchestrator` | `*` (all skills) |
+| `designer` | `playwright` |
+| `oracle` | none |
+| `librarian` | none |
+| `explorer` | none |
+
+### YAGNI Enforcement
+
+**The Minimalist's sacred truth: every line of code is a liability.**
+
+Use after major refactors or before finalizing PRs. Identifies unnecessary complexity, challenges premature abstractions, estimates LOC reduction, and enforces minimalism.
+
+### Playwright Integration
+
+**Browser automation for visual verification and testing.**
 
-#### Key Features
 - **Browser Automation**: Full Playwright capabilities (browsing, clicking, typing, scraping).
 - **Screenshots**: Capture visual state of any web page.
-- **Sandboxed Output**: Screenshots are safely saved to `/tmp/playwright-mcp-output/`.
+- **Sandboxed Output**: Screenshots saved to session subdirectory (check tool output for path).
+
+### Customizing Agent Skills
+
+Override skills per-agent in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson):
+
+```json
+{
+  "agents": {
+    "orchestrator": {
+      "skills": ["*"]
+    },
+    "designer": {
+      "skills": ["playwright"]
+    }
+  }
+}
+```
 
 ---
 
@@ -499,42 +443,67 @@ Built-in Model Context Protocol servers (enabled by default):
 
 ### Disabling MCPs
 
-You can disable specific MCP servers in your config:
-
-```json
-{
-  "disabled_mcps": ["websearch", "grep_app"]
-}
-```
+You can disable specific MCP servers by adding them to the `disabled_mcps` array in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson).
 
 ---
 
 ## Configuration
 
-You can customize the behavior of the plugin via JSON configuration files.
-
-### Configuration Files
+### Files You Edit
 
-The plugin looks for configuration in two places (and merges them):
+| File | Purpose |
+|------|---------|
+| `~/.config/opencode/opencode.json` | OpenCode core settings (server port for tmux) |
+| `~/.config/opencode/oh-my-opencode-slim.json` | Plugin settings (agents, tmux, MCPs) |
+| `.opencode/oh-my-opencode-slim.json` | Project-local plugin overrides (optional) |
 
-1. **User Global**: `~/.config/opencode/oh-my-opencode-slim.json` (or OS equivalent)
-2. **Project Local**: `./.opencode/oh-my-opencode-slim.json`
+> **Platform paths:** On Windows, user config may also be at `%APPDATA%\opencode\`.
 
-| Platform | User Config Path |
-| :--- | :--- |
-| **Windows** | `~/.config/opencode/oh-my-opencode-slim.json` or `%APPDATA%\opencode\oh-my-opencode-slim.json` |
-| **macOS/Linux** | `~/.config/opencode/oh-my-opencode-slim.json` |
+---
 
-### Disabling Agents
+### Plugin Config (`oh-my-opencode-slim.json`)
 
-You can disable specific agents using the `disabled_agents` array:
+All plugin options in one file:
 
 ```json
 {
-  "disabled_agents": ["multimodal-looker", "code-simplicity-reviewer"]
+  "tmux": {
+    "enabled": true,
+    "layout": "main-vertical",
+    "main_pane_size": 60
+  },
+  "disabled_agents": [],
+  "disabled_mcps": ["websearch", "grep_app"],
+  "agents": {
+    "orchestrator": {
+      "model": "openai/gpt-5.2-codex",
+      "variant": "high",
+      "skills": ["*"]
+    },
+    "explorer": {
+      "model": "opencode/glm-4.7",
+      "variant": "low"
+    },
+    "designer": {
+      "skills": ["playwright"]
+    }
+  }
 }
 ```
 
+#### Option Reference
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `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) |
+
 ---
 
 ## Uninstallation

package/dist/agents/designer.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "./orchestrator";
+export declare function createDesignerAgent(model: string): AgentDefinition;

package/dist/agents/explorer.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "./orchestrator";
+export declare function createExplorerAgent(model: string): AgentDefinition;

package/dist/agents/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/config-manager.d.ts

@@ -1,4 +1,10 @@
 import type { ConfigMergeResult, DetectedConfig, InstallConfig } from "./types";
+/**
+ * Strip JSON comments (single-line // and multi-line) and trailing commas for JSONC support.
+ * Note: When config files are read and written back, any comments will be lost as
+ * JSON.stringify produces standard JSON without comments.
+ */
+export declare function stripJsonComments(json: string): string;
 export declare function isOpenCodeInstalled(): Promise<boolean>;
 export declare function isTmuxInstalled(): Promise<boolean>;
 export declare function getOpenCodeVersion(): Promise<string | null>;

package/dist/cli/config-manager.test.d.ts

@@ -0,0 +1 @@
+export {};