oh-my-opencode-slim 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,196 @@
+# 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.
+
+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.
+
+---
+
+## Installation
+
+### For Humans
+
+> **Prerequisite: [Bun](https://bun.sh/) is required**
+
+1. **Install OpenCode** (if not already installed):
+   ```bash
+   # Check if installed
+   opencode --version
+   
+   # If not, see: https://opencode.ai/docs
+   ```
+
+2. **Add the plugin to your OpenCode config** (`~/.config/opencode/opencode.json`):
+   ```json
+   {
+     "plugin": [
+       "oh-my-opencode-slim"
+     ]
+   }
+   ```
+
+3. **Verify setup**:
+   ```bash
+   opencode
+   ```
+
+### 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:
+
+#### 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
+```
+
+#### Step 2: Add Plugin to Config
+
+Edit `~/.config/opencode/opencode.json` and add `"oh-my-opencode-slim"` to the plugin array:
+
+```json
+{
+  "plugin": [
+    "oh-my-opencode-slim"
+  ]
+}
+```
+
+#### Step 3: Verify Setup
+
+```bash
+opencode --version  # Should be 1.0.150 or higher
+cat ~/.config/opencode/opencode.json  # Should contain "oh-my-opencode-slim" in plugin array
+```
+
+#### Step 4: Configure Authentication
+
+Add the Antigravity auth plugin to your config:
+```json
+{
+  "plugin": [
+    "oh-my-opencode-slim",
+    "opencode-antigravity-auth@latest"
+  ]
+}
+```
+
+Then authenticate:
+```bash
+opencode auth login
+# Select Provider: Google
+# Select Login method: OAuth with Google (Antigravity)
+```
+
+</details>
+
+---
+
+## Architecture & Flow
+
+The plugin follows a "Hub and Spoke" model:
+
+1. **The Orchestrator (Hub)**: The main entry point for user requests. It analyzes the task and decides which specialized agents to call.
+2. **Specialized Agents (Spokes)**: Domain-specific experts (e.g., UI/UX, Documentation, Architecture) that handle narrow tasks with high precision.
+3. **Background Manager**: A robust engine that allows the Orchestrator to "fire and forget" tasks (like deep codebase searches or documentation research) while continuing to work on other parts of the problem.
+
+### The Flow of a Request
+
+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 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.
+
+---
+
+## Agents
+
+| 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. |
+
+---
+
+## Tools & Capabilities
+
+### Background Tasks
+
+The plugin provides three core tools to manage asynchronous work:
+
+- `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.
+
+---
+
+## Configuration
+
+You can customize the behavior of the plugin via JSON configuration files.
+
+### Configuration Files
+
+The plugin looks for configuration in two places (and merges them):
+
+1. **User Global**: `~/.config/opencode/oh-my-opencode-slim.json` (or OS equivalent)
+2. **Project Local**: `./.opencode/oh-my-opencode-slim.json`
+
+| 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
+
+You can disable specific agents using the `disabled_agents` array:
+
+```json
+{
+  "disabled_agents": ["multimodal-looker", "code-simplicity-reviewer"]
+}
+```
+
+---
+
+## 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)**:
+   ```bash
+   rm -f ~/.config/opencode/oh-my-opencode-slim.json
+   rm -f .opencode/oh-my-opencode-slim.json
+   ```
+
+---
+
+## Credits
+
+This is a slimmed-down fork of [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) by [@code-yeongyu](https://github.com/code-yeongyu).
+
+---
+
+## License
+
+MIT

package/dist/agents/document-writer.d.ts

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

package/dist/agents/explore.d.ts

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

package/dist/agents/frontend.d.ts

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

package/dist/agents/index.d.ts

@@ -0,0 +1,6 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import { type PluginConfig } from "../config";
+import { type AgentDefinition } from "./orchestrator";
+export type { AgentDefinition } from "./orchestrator";
+export declare function createAgents(config?: PluginConfig): AgentDefinition[];
+export declare function getAgentConfigs(config?: PluginConfig): Record<string, AgentConfig>;

package/dist/agents/librarian.d.ts

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

package/dist/agents/multimodal.d.ts

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

package/dist/agents/oracle.d.ts

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

package/dist/agents/orchestrator.d.ts

@@ -0,0 +1,7 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    config: AgentConfig;
+}
+export declare function createOrchestratorAgent(model: string, subAgents: AgentDefinition[]): AgentDefinition;

package/dist/agents/simplicity-reviewer.d.ts

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

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schema";
+export { loadPluginConfig } from "./loader";

package/dist/config/loader.d.ts

@@ -0,0 +1,2 @@
+import { type PluginConfig } from "./schema";
+export declare function loadPluginConfig(directory: string): PluginConfig;

package/dist/config/schema.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const AgentConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodOptional<z.ZodString>;
+    prompt_append: z.ZodOptional<z.ZodString>;
+    disable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+export declare const PluginConfigSchema: z.ZodObject<{
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        prompt: z.ZodOptional<z.ZodString>;
+        prompt_append: z.ZodOptional<z.ZodString>;
+        disable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    disabled_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+export type AgentName = "orchestrator" | "oracle" | "librarian" | "explore" | "frontend-ui-ux-engineer" | "document-writer" | "multimodal-looker" | "code-simplicity-reviewer";
+export declare const DEFAULT_MODELS: Record<AgentName, string>;

package/dist/features/background-manager.d.ts

@@ -0,0 +1,32 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export interface BackgroundTask {
+    id: string;
+    sessionId: string;
+    description: string;
+    agent: string;
+    status: "pending" | "running" | "completed" | "failed";
+    result?: string;
+    error?: string;
+    startedAt: Date;
+    completedAt?: Date;
+}
+export interface LaunchOptions {
+    agent: string;
+    prompt: string;
+    description: string;
+    parentSessionId: string;
+    model?: string;
+}
+export declare class BackgroundTaskManager {
+    private tasks;
+    private client;
+    private directory;
+    private pollInterval?;
+    constructor(ctx: PluginInput);
+    launch(opts: LaunchOptions): Promise<BackgroundTask>;
+    getResult(taskId: string, block?: boolean, timeout?: number): Promise<BackgroundTask | null>;
+    cancel(taskId?: string): number;
+    private startPolling;
+    private pollAllTasks;
+    private pollTask;
+}

package/dist/features/index.d.ts

@@ -0,0 +1 @@
+export { BackgroundTaskManager, type BackgroundTask, type LaunchOptions } from "./background-manager";

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const OhMyOpenCodeSlim: Plugin;
+export default OhMyOpenCodeSlim;
+export type { PluginConfig, AgentConfig, AgentName } from "./config";