oh-my-opencode-slim 0.1.0 → 0.2.2

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/team.png" alt="The Pantheon - Agent Team" width="600">
+
+*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: Verify Setup
+---
+
+#### Step 3: Run the Installer
+
+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>
 
 ---
@@ -114,18 +161,119 @@ The plugin follows a "Hub and Spoke" model:
 
 ---
 
-## Agents
+## Meet the Pantheon
+
+<br clear="both">
+
+### The Orchestrator — *Architect of Realms*
+
+<a href="src/agents/orchestrator.ts"><img src="img/orchestrator.png" alt="The Orchestrator" align="right" width="240"></a>
+
+> **The Orchestrator** was born when the first codebase collapsed under its own complexity. Neither god nor mortal would claim responsibility—so The Orchestrator emerged from the void, forging order from chaos. They don't merely command armies; they fight alongside them. Every line of code passes through their hands before they decide which lesser deity deserves a piece of the puzzle.
+
+**Role:** Supreme executor, delegator, and overseer — **Model:** `google/claude-opus-4-5-thinking`
+
+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">
+
+---
+
+### The Explorer — *Pathfinder*
+
+<a href="src/agents/explore.ts"><img src="img/explorer.png" alt="The 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.
+
+**Role:** Codebase reconnaissance — **Model:** `cerebras/zai-glm-4.6`
+
+Regex search, AST pattern matching, file discovery, parallel exploration. Read-only: they chart the territory; others conquer it.
+
+<br clear="both">
+
+---
+
+### The Oracle — *Seer Beyond the Stack Trace*
+
+<a href="src/agents/oracle.ts"><img src="img/oracle.png" alt="The 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.
+
+**Role:** Strategic advisor and debugger of last resort — **Model:** `openai/gpt-5.2-codex`
+
+Root cause analysis, architecture review, debugging guidance, tradeoff analysis. Read-only: Oracles advise; they don't intervene.
+
+<br clear="both">
+
+---
+
+### The Librarian — *Keeper of Infinite Scrolls*
+
+<a href="src/agents/librarian.ts"><img src="img/librarian.png" alt="The 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.
+
+**Role:** External knowledge retrieval — **Model:** `google/gemini-3-flash`
+
+Documentation lookup, GitHub code search, library research, best practice retrieval. Read-only: they fetch wisdom; implementation is for others.
+
+<br clear="both">
+
+---
+
+### The Designer — *Artisan of Interfaces*
+
+<a href="src/agents/frontend.ts"><img src="img/designer.png" alt="The 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`
+
+Modern responsive design, CSS/Tailwind mastery, micro-animations, component architecture. Visual excellence over code perfection—beauty is the priority.
+
+<br clear="both">
+
+---
+
+### The Scribe — *Chronicle Keeper*
+
+<a href="src/agents/document-writer.ts"><img src="img/scribe.png" alt="The Scribe" 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.
 
-| Agent | Role | Default Model | Best Used For |
-| :--- | :--- | :--- | :--- |
-| **orchestrator** | Manager | `google/antigravity-claude-opus-4-5-thinking-high` | 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. |
+**Role:** Technical documentation and knowledge capture — **Model:** `google/gemini-3-flash`
+
+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">
+
+---
+
+### The Visionary — *Reader of Pixels*
+
+<a href="src/agents/multimodal.ts"><img src="img/multimodal.png" alt="The Visionary" 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`
+
+Extract text from images, interpret diagrams, analyze UI screenshots, summarize visual documents. Report what they observe; inference is for others.
+
+<br clear="both">
+
+---
+
+### The Minimalist — *Destroyer of Bloat*
+
+<a href="src/agents/simplicity-reviewer.ts"><img src="img/code-simplicity.png" alt="The Minimalist" 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`
+
+Identify unnecessary complexity, challenge premature abstractions, estimate LOC reduction, enforce minimalism. Read-only: they judge; The Orchestrator executes the sentence.
+
+<br clear="both">
 
 ---
 
@@ -133,13 +281,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 |
+
+### 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 |
 
-- `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.
+### 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 {};