oh-my-opencode-slim 0.1.0 → 0.2.1

package/README.md

@@ -1,8 +1,16 @@
+<div align="center">
+
 # oh-my-opencode-slim
 
-A lightweight, powerful agent orchestration plugin for **OpenCode**. This is a 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.
+**A lightweight, powerful agent orchestration plugin for OpenCode**
+
+<img src="img/hero.png" alt="Agent Orchestration - Hub and Spoke Model" width="520">
+
+*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.*
 
-It transforms 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.
+</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.
 
 ---
 
@@ -10,86 +18,125 @@ It transforms your AI assistant into a manager capable of delegating complex tas
 
 ### For Humans
 
-> **Prerequisite: [Bun](https://bun.sh/) is required**
+Run the interactive installer:
 
-1. **Install OpenCode** (if not already installed):
-   ```bash
-   # Check if installed
-   opencode --version
-   
-   # If not, see: https://opencode.ai/docs
-   ```
+```bash
+bunx oh-my-opencode-slim install
+```
 
-2. **Add the plugin to your OpenCode config** (`~/.config/opencode/opencode.json`):
-   ```json
-   {
-     "plugin": [
-       "oh-my-opencode-slim"
-     ]
-   }
-   ```
+Or use non-interactive mode:
 
-3. **Verify setup**:
-   ```bash
-   opencode
-   ```
+```bash
+bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=no
+```
+
+**Alternative: Ask any coding agent**
+
+Paste this into Claude Code, AmpCode, Cursor, or any coding agent:
+
+```
+Install and configure by following the instructions here:
+https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md
+```
 
 ### For LLM Agents
 
 <details>
 <summary>Instructions for LLM Agents (click to expand)</summary>
 
-If you're an LLM Agent helping set up oh-my-opencode-slim, follow these steps:
+If you're an LLM Agent helping set up oh-my-opencode-slim, follow these steps.
+
+---
 
 #### Step 1: Check OpenCode Installation
 
 ```bash
-if command -v opencode &> /dev/null; then
-    echo "OpenCode $(opencode --version) is installed"
-else
-    echo "OpenCode is not installed. Please install it first."
-    echo "Ref: https://opencode.ai/docs"
-fi
+opencode --version
 ```
 
-#### Step 2: Add Plugin to Config
+If not installed, direct the user to https://opencode.ai/docs first.
 
-Edit `~/.config/opencode/opencode.json` and add `"oh-my-opencode-slim"` to the plugin array:
+---
 
-```json
-{
-  "plugin": [
-    "oh-my-opencode-slim"
-  ]
-}
-```
+#### Step 2: Ask About Provider Access
+
+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)*
+
+---
+
+#### Step 3: Run the Installer
 
-#### Step 3: Verify Setup
+Based on answers, run:
 
 ```bash
-opencode --version  # Should be 1.0.150 or higher
-cat ~/.config/opencode/opencode.json  # Should contain "oh-my-opencode-slim" in plugin array
+bunx oh-my-opencode-slim install --no-tui --antigravity=<yes|no> --openai=<yes|no> --cerebras=<yes|no>
 ```
 
-#### Step 4: Configure Authentication
+**Examples:**
+```bash
+# Antigravity + OpenAI
+bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=no
 
-Add the Antigravity auth plugin to your config:
-```json
-{
-  "plugin": [
-    "oh-my-opencode-slim",
-    "opencode-antigravity-auth@latest"
-  ]
-}
+# OpenAI only
+bunx oh-my-opencode-slim install --no-tui --antigravity=no --openai=yes --cerebras=no
+
+# All providers
+bunx oh-my-opencode-slim install --no-tui --antigravity=yes --openai=yes --cerebras=yes
 ```
 
-Then authenticate:
+The installer automatically:
+- Adds the plugin to `~/.config/opencode/opencode.json`
+- Adds `opencode-antigravity-auth` plugin (if Antigravity enabled)
+- Configures Google provider with model definitions
+- Generates agent model mappings in `~/.config/opencode/oh-my-opencode-slim.json`
+
+---
+
+#### Step 4: Authentication
+
+After installation, guide the user:
+
+**For Antigravity:**
 ```bash
 opencode auth login
-# Select Provider: Google
-# Select Login method: OAuth with Google (Antigravity)
+# 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
+```
+
+---
+
+#### Troubleshooting
+
+If the installer fails, check the expected config format:
+```bash
+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>
 
 ---
@@ -118,14 +165,14 @@ The plugin follows a "Hub and Spoke" model:
 
 | Agent | Role | Default Model | Best Used For |
 | :--- | :--- | :--- | :--- |
-| **orchestrator** | Manager | `google/antigravity-claude-opus-4-5-thinking-high` | Planning, task delegation, and overall coordination. |
+| **orchestrator** | Manager | `google/claude-opus-4-5-thinking` | Planning, task delegation, and overall coordination. |
 | **oracle** | Architect | `openai/gpt-5.2-codex` | Complex debugging, architectural decisions, and code reviews. |
 | **explore** | Searcher | `cerebras/zai-glm-4.6` | Fast codebase grep, finding patterns, and locating definitions. |
 | **librarian** | Researcher | `google/gemini-3-flash` | External library docs, GitHub examples, and API research. |
 | **frontend-ui-ux-engineer** | Designer | `google/gemini-3-flash` | Visual changes, CSS/styling, and React/Vue component polish. |
 | **document-writer** | Scribe | `google/gemini-3-flash` | Technical documentation, READMEs, and inline code comments. |
 | **multimodal-looker** | Visionary | `google/gemini-3-flash` | Analyzing screenshots, wireframes, or UI designs. |
-| **code-simplicity-reviewer** | Minimalist | `google/antigravity-claude-opus-4-5-thinking-high` | Ruthless code simplification and YAGNI principle enforcement. |
+| **code-simplicity-reviewer** | Minimalist | `google/claude-opus-4-5-thinking` | Ruthless code simplification and YAGNI principle enforcement. |
 
 ---
 
@@ -133,13 +180,64 @@ The plugin follows a "Hub and Spoke" model:
 
 ### Background Tasks
 
-The plugin provides three core tools to manage asynchronous work:
+The plugin provides tools to manage asynchronous work:
+
+| Tool | Description |
+|------|-------------|
+| `background_task` | Launch an agent in a new session (`sync=true` blocks, `sync=false` runs in background) |
+| `background_output` | Fetch the result of a background task by ID |
+| `background_cancel` | Abort running tasks |
 
-- `background_task`: Launches an agent in a new session.
-  - `sync=true`: Blocks until the agent finishes (ideal for quick sub-tasks).
-  - `sync=false`: Runs in the background (ideal for long searches or research).
-- `background_output`: Fetches the result of a background task using its ID.
-- `background_cancel`: Aborts running tasks if they are no longer needed.
+### LSP Tools
+
+Language Server Protocol integration for code intelligence:
+
+| Tool | Description |
+|------|-------------|
+| `lsp_goto_definition` | Jump to symbol definition |
+| `lsp_find_references` | Find all usages of a symbol across the workspace |
+| `lsp_diagnostics` | Get errors/warnings from the language server |
+| `lsp_rename` | Rename a symbol across all files |
+
+### Code Search Tools
+
+Fast code search and refactoring:
+
+| Tool | Description |
+|------|-------------|
+| `grep` | Fast content search using ripgrep |
+| `ast_grep_search` | AST-aware code pattern matching (25 languages) |
+| `ast_grep_replace` | AST-aware code refactoring with dry-run support |
+
+### Quota Tool
+
+For Antigravity users:
+
+| Tool | Description |
+|------|-------------|
+| `antigravity_quota` | Check API quota for all Antigravity accounts (compact view with progress bars) |
+
+---
+
+## MCP Servers
+
+Built-in Model Context Protocol servers (enabled by default):
+
+| 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
+
+You can disable specific MCP servers in your config:
+
+```json
+{
+  "disabled_mcps": ["websearch", "grep_app"]
+}
+```
 
 ---
 

package/dist/agents/index.d.ts

@@ -1,6 +1,49 @@
-import type { AgentConfig } from "@opencode-ai/sdk";
-import { type PluginConfig } from "../config";
+import type { AgentConfig as SDKAgentConfig } from "@opencode-ai/sdk";
+import { type AgentName, type PluginConfig } from "../config";
 import { type AgentDefinition } from "./orchestrator";
+import { createOracleAgent } from "./oracle";
+import { createLibrarianAgent } from "./librarian";
+import { createExploreAgent } from "./explore";
+import { createFrontendAgent } from "./frontend";
+import { createDocumentWriterAgent } from "./document-writer";
+import { createMultimodalAgent } from "./multimodal";
+import { createSimplicityReviewerAgent } from "./simplicity-reviewer";
 export type { AgentDefinition } from "./orchestrator";
+type SubagentName = Exclude<AgentName, "orchestrator">;
+/** Short descriptions for each subagent (used in tool descriptions) */
+export declare const SUBAGENT_INFO: {
+    readonly explore: {
+        readonly factory: typeof createExploreAgent;
+        readonly shortDesc: "codebase grep";
+    };
+    readonly librarian: {
+        readonly factory: typeof createLibrarianAgent;
+        readonly shortDesc: "docs/GitHub";
+    };
+    readonly oracle: {
+        readonly factory: typeof createOracleAgent;
+        readonly shortDesc: "strategy";
+    };
+    readonly "frontend-ui-ux-engineer": {
+        readonly factory: typeof createFrontendAgent;
+        readonly shortDesc: "UI/UX";
+    };
+    readonly "document-writer": {
+        readonly factory: typeof createDocumentWriterAgent;
+        readonly shortDesc: "docs";
+    };
+    readonly "multimodal-looker": {
+        readonly factory: typeof createMultimodalAgent;
+        readonly shortDesc: "image/visual analysis";
+    };
+    readonly "code-simplicity-reviewer": {
+        readonly factory: typeof createSimplicityReviewerAgent;
+        readonly shortDesc: "code review";
+    };
+};
+/** Generate agent list string for tool descriptions */
+export declare function getAgentListDescription(): string;
+/** Get list of agent names */
+export declare function getAgentNames(): SubagentName[];
 export declare function createAgents(config?: PluginConfig): AgentDefinition[];
-export declare function getAgentConfigs(config?: PluginConfig): Record<string, AgentConfig>;
+export declare function getAgentConfigs(config?: PluginConfig): Record<string, SDKAgentConfig>;

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

@@ -0,0 +1,10 @@
+import type { ConfigMergeResult, DetectedConfig, InstallConfig } from "./types";
+export declare function isOpenCodeInstalled(): Promise<boolean>;
+export declare function getOpenCodeVersion(): Promise<string | null>;
+export declare function fetchLatestVersion(packageName: string): Promise<string | null>;
+export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
+export declare function addAuthPlugins(installConfig: InstallConfig): Promise<ConfigMergeResult>;
+export declare function addProviderConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;
+export declare function writeLiteConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function detectCurrentConfig(): DetectedConfig;

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};