ayush-opencode 0.1.1 → 0.2.0

package/README.md

@@ -5,6 +5,7 @@ Custom OpenCode plugin with specialized subagents and orchestration injection.
 ## Features
 
 - **4 Custom Subagents**: Explorer, Librarian, Oracle, UI-Planner
+- **Auto-Loaded MCP Servers**: exa, grep_app, sequential-thinking (no manual config needed!)
 - **Orchestration Injection**: Automatically teaches Build/Plan agents how to delegate tasks
 - **Portable**: Install on any machine via opencode.json
 
@@ -14,7 +15,7 @@ Just add to your `opencode.json` — OpenCode will auto-install the plugin:
 
 ```json
 {
-  "plugin": ["ayush-opencode@0.1.0"]
+  "plugin": ["ayush-opencode@0.2.0"]
 }
 ```
 
@@ -28,7 +29,7 @@ That's it! Restart OpenCode and the plugin is ready to use.
 
 ```json
 {
-  "plugin": ["ayush-opencode@0.1.0"]
+  "plugin": ["ayush-opencode@0.2.0"]
 }
 ```
 
@@ -40,10 +41,10 @@ Simply change the version in your config and restart OpenCode:
 
 ```jsonc
 // Change from:
-"plugin": ["ayush-opencode@0.1.0"]
+"plugin": ["ayush-opencode@0.2.0"]
 
 // To:
-"plugin": ["ayush-opencode@0.2.0"]
+"plugin": ["ayush-opencode@0.3.0"]
 ```
 
 OpenCode will detect the version mismatch and install the new version automatically.
@@ -105,38 +106,91 @@ This plugin automatically injects delegation guidelines into OpenCode's Build an
 | "Should I use Redux or Zustand?" | @oracle |
 | "Make this dashboard look better" | @ui-planner |
 
-## MCP Tools Required
+## Configuration (Optional)
+
+You can customize agent models or disable agents by creating a config file.
 
-This plugin assumes you have the following MCP servers configured:
+### Config File Locations
 
-- `exa` - For web search and code context
-- `grep_app` - For GitHub code search
-- `sequential-thinking` - For complex reasoning
+| Location | Priority | Use Case |
+|----------|----------|----------|
+| `~/.config/opencode/ayush-opencode.json` | Base | User-level defaults |
+| `.opencode/ayush-opencode.json` | Override | Project-specific settings |
 
-Configure these in your `opencode.json`:
+Project config overrides user config when both exist.
+
+### Config Options
 
 ```json
 {
-  "mcp": {
-    "exa": {
-      "type": "local",
-      "command": ["npx", "-y", "mcp-remote", "https://mcp.exa.ai/mcp?tools=web_search_exa,get_code_context_exa,crawling_exa"],
-      "enabled": true
-    },
-    "grep_app": {
-      "type": "remote",
-      "url": "https://mcp.grep.app",
-      "enabled": true
-    },
-    "sequential-thinking": {
-      "type": "local",
-      "command": ["npx", "@modelcontextprotocol/server-sequential-thinking"],
-      "enabled": true
-    }
+  "agents": {
+    "explorer": { "model": "anthropic/claude-haiku-4-5" },
+    "librarian": { "model": "anthropic/claude-sonnet-4-5" },
+    "oracle": { "model": "openai/gpt-5.2-high" },
+    "ui-planner": { "model": "google/gemini-3-pro-high" }
+  },
+  "disabled_agents": [],
+  "disabled_mcps": []
+}
+```
+
+### Override Models
+
+To use different models for specific agents:
+
+```json
+{
+  "agents": {
+    "explorer": { "model": "anthropic/claude-sonnet-4" },
+    "oracle": { "model": "openai/gpt-4o" }
   }
 }
 ```
 
+### Disable Agents
+
+To disable specific agents:
+
+```json
+{
+  "disabled_agents": ["oracle", "ui-planner"]
+}
+```
+
+Available agent names: `explorer`, `librarian`, `oracle`, `ui-planner`
+
+## Auto-Loaded MCP Servers
+
+This plugin **automatically loads** the following MCP servers — no manual configuration needed!
+
+| MCP Server | Type | Description |
+|------------|------|-------------|
+| `exa` | HTTP Streamable | Web search, code context, URL crawling (no API key required) |
+| `grep_app` | Remote | GitHub code search across millions of repos |
+| `sequential-thinking` | Local | Structured reasoning for complex problems |
+
+### How It Works
+
+When you install this plugin, these MCP servers are automatically injected into OpenCode's config:
+
+- **Your other MCPs are preserved** — If you have `supabase`, `memcontext`, or any custom MCPs, they continue to work
+- **Conflicts use our config** — If you have `exa` configured differently, our version takes priority
+- **Disable if needed** — Use `disabled_mcps` config to opt-out (see below)
+
+### Disable Specific MCPs
+
+If you want to keep your own MCP config for a server we provide:
+
+```json
+{
+  "disabled_mcps": ["exa"]
+}
+```
+
+Available MCP names: `exa`, `grep_app`, `sequential-thinking`
+
+This will skip injecting our `exa` config, allowing your custom one to remain.
+
 ## Development
 
 ```bash

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { AyushOpenCodeConfigSchema, AgentNameSchema, AgentOverrideConfigSchema, AgentOverridesSchema, type AyushOpenCodeConfig, type AgentName, type AgentOverrideConfig, type AgentOverrides, } from "./schema";
+export { loadPluginConfig } from "./loader";

package/dist/config/loader.d.ts

@@ -0,0 +1,6 @@
+import { type AyushOpenCodeConfig } from "./schema";
+/**
+ * Load plugin configuration from user and project paths
+ * Project config takes priority over user config
+ */
+export declare function loadPluginConfig(projectDirectory: string): AyushOpenCodeConfig;

package/dist/config/schema.d.ts

@@ -0,0 +1,179 @@
+import { z } from "zod";
+/**
+ * Agent names that can be configured
+ */
+export declare const AgentNameSchema: z.ZodEnum<["explorer", "librarian", "oracle", "ui-planner"]>;
+export type AgentName = z.infer<typeof AgentNameSchema>;
+/**
+ * Configuration for overriding an agent's settings
+ * Only model override is supported - keeps it simple
+ */
+export declare const AgentOverrideConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
+}, {
+    model?: string | undefined;
+}>;
+export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;
+/**
+ * Agent overrides mapping
+ */
+export declare const AgentOverridesSchema: z.ZodObject<{
+    explorer: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+    }, {
+        model?: string | undefined;
+    }>>;
+    librarian: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+    }, {
+        model?: string | undefined;
+    }>>;
+    oracle: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+    }, {
+        model?: string | undefined;
+    }>>;
+    "ui-planner": z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+    }, {
+        model?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    explorer?: {
+        model?: string | undefined;
+    } | undefined;
+    librarian?: {
+        model?: string | undefined;
+    } | undefined;
+    oracle?: {
+        model?: string | undefined;
+    } | undefined;
+    "ui-planner"?: {
+        model?: string | undefined;
+    } | undefined;
+}, {
+    explorer?: {
+        model?: string | undefined;
+    } | undefined;
+    librarian?: {
+        model?: string | undefined;
+    } | undefined;
+    oracle?: {
+        model?: string | undefined;
+    } | undefined;
+    "ui-planner"?: {
+        model?: string | undefined;
+    } | undefined;
+}>;
+export type AgentOverrides = z.infer<typeof AgentOverridesSchema>;
+/**
+ * Main configuration schema for ayush-opencode
+ */
+export declare const AyushOpenCodeConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodObject<{
+        explorer: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+        }, {
+            model?: string | undefined;
+        }>>;
+        librarian: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+        }, {
+            model?: string | undefined;
+        }>>;
+        oracle: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+        }, {
+            model?: string | undefined;
+        }>>;
+        "ui-planner": z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            model?: string | undefined;
+        }, {
+            model?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        explorer?: {
+            model?: string | undefined;
+        } | undefined;
+        librarian?: {
+            model?: string | undefined;
+        } | undefined;
+        oracle?: {
+            model?: string | undefined;
+        } | undefined;
+        "ui-planner"?: {
+            model?: string | undefined;
+        } | undefined;
+    }, {
+        explorer?: {
+            model?: string | undefined;
+        } | undefined;
+        librarian?: {
+            model?: string | undefined;
+        } | undefined;
+        oracle?: {
+            model?: string | undefined;
+        } | undefined;
+        "ui-planner"?: {
+            model?: string | undefined;
+        } | undefined;
+    }>>;
+    disabled_agents: z.ZodOptional<z.ZodArray<z.ZodEnum<["explorer", "librarian", "oracle", "ui-planner"]>, "many">>;
+    disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodEnum<["exa", "grep_app", "sequential-thinking"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    $schema?: string | undefined;
+    agents?: {
+        explorer?: {
+            model?: string | undefined;
+        } | undefined;
+        librarian?: {
+            model?: string | undefined;
+        } | undefined;
+        oracle?: {
+            model?: string | undefined;
+        } | undefined;
+        "ui-planner"?: {
+            model?: string | undefined;
+        } | undefined;
+    } | undefined;
+    disabled_agents?: ("explorer" | "librarian" | "oracle" | "ui-planner")[] | undefined;
+    disabled_mcps?: ("exa" | "grep_app" | "sequential-thinking")[] | undefined;
+}, {
+    $schema?: string | undefined;
+    agents?: {
+        explorer?: {
+            model?: string | undefined;
+        } | undefined;
+        librarian?: {
+            model?: string | undefined;
+        } | undefined;
+        oracle?: {
+            model?: string | undefined;
+        } | undefined;
+        "ui-planner"?: {
+            model?: string | undefined;
+        } | undefined;
+    } | undefined;
+    disabled_agents?: ("explorer" | "librarian" | "oracle" | "ui-planner")[] | undefined;
+    disabled_mcps?: ("exa" | "grep_app" | "sequential-thinking")[] | undefined;
+}>;
+export type AyushOpenCodeConfig = z.infer<typeof AyushOpenCodeConfigSchema>;

package/dist/index.d.ts

@@ -4,8 +4,12 @@
  * This plugin provides:
  * 1. Custom subagents: explorer, librarian, oracle, ui-planner
  * 2. Orchestration injection into Build/Plan agents for better delegation
+ * 3. Auto-loaded MCP servers: exa, grep_app, sequential-thinking
+ * 4. Optional configuration via ayush-opencode.json for model/MCP overrides
  */
 import type { Plugin } from "@opencode-ai/plugin";
 declare const AyushOpenCodePlugin: Plugin;
 export default AyushOpenCodePlugin;
 export type { BuiltinAgentName, AgentOverrideConfig, AgentOverrides, } from "./agents";
+export type { AyushOpenCodeConfig, AgentName, } from "./config";
+export type { McpName } from "./mcp";