oh-my-opencode-slim 0.3.7 → 0.4.0

package/README.md

@@ -10,7 +10,7 @@
 
 </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.google) subscription recommended.** The pantheon is tuned for Antigravity's model routing. Other providers work, but you'll get the best experience with Antigravity.
 
@@ -23,14 +23,28 @@
   - [For LLM Agents](#for-llm-agents)
 - [🏗️ **Architecture & Flow**](#architecture--flow)
 - [🏛️ **Meet the Pantheon**](#meet-the-pantheon)
-- [🛠️ **Tools & Capabilities**](#tools--capabilities)
+  - [Orchestrator](#orchestrator)
+  - [Explorer](#explorer)
+  - [Oracle](#oracle)
+  - [Librarian](#librarian)
+  - [Designer](#designer)
 - [🧩 **Skills**](#-skills)
-- [⚙️ **Configuration Guide**](#configuration-guide)
-  - [Locations & Precedence](#locations--precedence)
-  - [General Settings](#general-settings)
-  - [Agent Configuration](#agent-configuration)
-  - [Tmux Setup](#tmux-setup)
-  - [MCP Management](#mcp-management)
+  - [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)
+- [🔌 **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)
 
 ---
@@ -51,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:
@@ -125,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
 ```
 
 ---
@@ -177,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.
 
 ---
 
@@ -211,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.*
 
@@ -252,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.*
 
@@ -268,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.
@@ -340,6 +304,28 @@ Identify unnecessary complexity, challenge premature abstractions, estimate LOC
 - **Auto-Cleanup**: Panes close when agents finish, layout rebalances
 - **Zero Overhead**: Works with OpenCode's built-in `task` tool AND our `background_task` tool
 
+#### 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**:
+   ```bash
+   tmux
+   opencode
+   ```
+
+#### Layout Options
+
+| Layout | Description |
+|--------|-------------|
+| `main-vertical` | Your session on the left (60%), agents stacked on the right |
+| `main-horizontal` | Your session on top (60%), agents stacked below |
+| `tiled` | All panes in equal-sized grid |
+| `even-horizontal` | All panes side by side |
+| `even-vertical` | All panes stacked vertically |
+
+*See the [Option Reference](#option-reference) for detailed configuration.*
+
 ---
 
 ### Quota Tool
@@ -393,142 +379,137 @@ Fast code search and refactoring:
 
 ## 🧩 Skills
 
-Skills are specialized capabilities that combine MCP servers with specific instructions for the Orchestrator.
-
-### Playwright Integration
-
-**The Orchestrator's eyes and hands in the browser.**
+Skills are specialized capabilities that agents can use. Each agent has a default set of skills, which you can override in the agent config.
 
-| 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 |
+### Available Skills
 
-#### 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/`.
+| Skill | Description |
+|-------|-------------|
+| `yagni-enforcement` | Code complexity analysis and YAGNI enforcement |
+| `playwright` | Browser automation via Playwright MCP |
 
----
+### Default Skill Assignments
 
-## ⚙️ Configuration Guide
+| Agent | Default Skills |
+|-------|----------------|
+| `orchestrator` | `*` (all skills) |
+| `designer` | `playwright` |
+| `oracle` | none |
+| `librarian` | none |
+| `explorer` | none |
 
-The Pantheon listens to your commands through sacred JSON scriptures. Here is how you shape their behavior.
+### YAGNI Enforcement
 
-### Locations & Precedence
+**The Minimalist's sacred truth: every line of code is a liability.**
 
-The plugin merges configuration from two locations. Settings in the **Project Local** file override those in the **User Global** file.
+Use after major refactors or before finalizing PRs. Identifies unnecessary complexity, challenges premature abstractions, estimates LOC reduction, and enforces minimalism.
 
-| Level | Path | Scope |
-| :--- | :--- | :--- |
-| **User Global** | `~/.config/opencode/oh-my-opencode-slim.json` | All projects for this user |
-| **Project Local** | `./.opencode/oh-my-opencode-slim.json` | This specific repository |
+### Playwright Integration
 
-> **Note for Windows Users:** The global config is located at `%APPDATA%\opencode\oh-my-opencode-slim.json` or `~/.config/opencode/oh-my-opencode-slim.json`.
+**Browser automation for visual verification and testing.**
 
----
+- **Browser Automation**: Full Playwright capabilities (browsing, clicking, typing, scraping).
+- **Screenshots**: Capture visual state of any web page.
+- **Sandboxed Output**: Screenshots saved to session subdirectory (check tool output for path).
 
-### General Settings
+### Customizing Agent Skills
 
-#### OpenCode Server
-To enable certain integrations (like Tmux), you must first enable the OpenCode HTTP server in your main `opencode.json` file.
+Override skills per-agent in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson):
 
-**File:** `~/.config/opencode/opencode.json`
 ```json
 {
-  "server": {
-    "port": 4096
+  "agents": {
+    "orchestrator": {
+      "skills": ["*"]
+    },
+    "designer": {
+      "skills": ["playwright"]
+    }
   }
 }
 ```
 
 ---
 
-### Agent Configuration
+## MCP Servers
 
-You can customize the underlying LLM and reasoning effort for each deity in the Pantheon.
+Built-in Model Context Protocol servers (enabled by default):
 
-**File:** `oh-my-opencode-slim.json`
-```json
-{
-  "agents": {
-    "orchestrator": {
-      "model": "openai/gpt-5.2-codex",
-      "variant": "high"
-    },
-    "explore": {
-      "model": "opencode/glm-4.7",
-      "variant": "low"
-    }
-  },
-  "disabled_agents": ["multimodal-looker", "code-simplicity-reviewer"]
-}
-```
+| MCP | Purpose | URL |
+|-----|---------|-----|
+| `websearch` | Real-time web search via Exa AI | `https://mcp.exa.ai/mcp` |
+| `context7` | Official library documentation | `https://mcp.context7.com/mcp` |
+| `grep_app` | GitHub code search via grep.app | `https://mcp.grep.app` |
 
-#### Agent Settings Reference
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `agents.<name>.model` | string | *Varies* | Override the LLM for a specific agent |
-| `agents.<name>.variant` | string | `"medium"` | Reasoning level (`low`, `medium`, `high`) |
-| `disabled_agents` | array | `[]` | List of agents to completely deactivate |
+### Disabling MCPs
+
+You can disable specific MCP servers by adding them to the `disabled_mcps` array in your [Plugin Config](#plugin-config-oh-my-opencode-slimjson).
 
 ---
 
-### Tmux Setup
+## Configuration
+
+### Files You Edit
+
+| 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) |
 
-Watch your agents work in real-time by enabling the Tmux integration. This requires the [OpenCode Server](#opencode-server) to be active.
+> **Platform paths:** On Windows, user config may also be at `%APPDATA%\opencode\`.
+
+---
+
+### Plugin Config (`oh-my-opencode-slim.json`)
+
+All plugin options in one file:
 
-**File:** `oh-my-opencode-slim.json`
 ```json
 {
   "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"]
+    }
   }
 }
 ```
 
-#### Tmux Settings Reference
+#### Option Reference
+
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `enabled` | boolean | `false` | Enable/disable tmux integration |
-| `layout` | string | `"main-vertical"` | Layout preset (see below) |
-| `main_pane_size` | number | `60` | Size of main session pane as % (20-80) |
-
-**Available Layouts:**
-- `main-vertical`: Main session left, agents stacked right.
-- `main-horizontal`: Main session top, agents stacked below.
-- `tiled`: Equal-sized grid.
-- `even-horizontal` / `even-vertical`: Evenly distributed panes.
-
----
-
-### MCP Management
-
-The Pantheon comes equipped with built-in Model Context Protocol (MCP) servers.
-
-| MCP | Purpose | URL |
-|-----|---------|-----|
-| `websearch` | Real-time web search via Exa AI | `https://mcp.exa.ai/mcp` |
-| `context7` | Official library documentation | `https://mcp.context7.com/mcp` |
-| `grep_app` | GitHub code search via grep.app | `https://mcp.grep.app` |
-
-#### Disabling MCPs
-If you wish to silence an MCP server, add it to the `disabled_mcps` array in your config:
-
-**File:** `oh-my-opencode-slim.json`
-```json
-{
-  "disabled_mcps": ["websearch", "grep_app"]
-}
-```
+| `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
+## Uninstallation
 
 1. **Remove the plugin from your OpenCode config**:
+
    Edit `~/.config/opencode/opencode.json` and remove `"oh-my-opencode-slim"` from the `plugin` array.
 
 2. **Remove configuration files (optional)**:

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 {};