ayush-opencode 0.1.2 → 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.
@@ -128,7 +129,8 @@ Project config overrides user config when both exist.
     "oracle": { "model": "openai/gpt-5.2-high" },
     "ui-planner": { "model": "google/gemini-3-pro-high" }
   },
-  "disabled_agents": []
+  "disabled_agents": [],
+  "disabled_mcps": []
 }
 ```
 
@@ -157,38 +159,38 @@ To disable specific agents:
 
 Available agent names: `explorer`, `librarian`, `oracle`, `ui-planner`
 
-## MCP Tools Required
+## 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
 
-This plugin assumes you have the following MCP servers configured:
+When you install this plugin, these MCP servers are automatically injected into OpenCode's config:
 
-- `exa` - For web search and code context
-- `grep_app` - For GitHub code search
-- `sequential-thinking` - For complex reasoning
+- **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)
 
-Configure these in your `opencode.json`:
+### Disable Specific MCPs
+
+If you want to keep your own MCP config for a server we provide:
 
 ```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
-    }
-  }
+  "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/schema.d.ts

@@ -138,6 +138,7 @@ export declare const AyushOpenCodeConfigSchema: z.ZodObject<{
         } | 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?: {
@@ -155,6 +156,7 @@ export declare const AyushOpenCodeConfigSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
     disabled_agents?: ("explorer" | "librarian" | "oracle" | "ui-planner")[] | undefined;
+    disabled_mcps?: ("exa" | "grep_app" | "sequential-thinking")[] | undefined;
 }, {
     $schema?: string | undefined;
     agents?: {
@@ -172,5 +174,6 @@ export declare const AyushOpenCodeConfigSchema: z.ZodObject<{
         } | 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,10 +4,12 @@
  * This plugin provides:
  * 1. Custom subagents: explorer, librarian, oracle, ui-planner
  * 2. Orchestration injection into Build/Plan agents for better delegation
- * 3. Optional configuration via ayush-opencode.json for model overrides
+ * 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";

package/dist/index.js

@@ -4618,6 +4618,13 @@ var coerce = {
   date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
+// src/mcp/types.ts
+var McpNameSchema = exports_external.enum([
+  "exa",
+  "grep_app",
+  "sequential-thinking"
+]);
+
 // src/config/schema.ts
 var AgentNameSchema = exports_external.enum([
   "explorer",
@@ -4637,7 +4644,8 @@ var AgentOverridesSchema = exports_external.object({
 var AyushOpenCodeConfigSchema = exports_external.object({
   $schema: exports_external.string().optional(),
   agents: AgentOverridesSchema.optional(),
-  disabled_agents: exports_external.array(AgentNameSchema).optional()
+  disabled_agents: exports_external.array(AgentNameSchema).optional(),
+  disabled_mcps: exports_external.array(McpNameSchema).optional()
 });
 // src/config/loader.ts
 import * as fs from "fs";
@@ -4691,10 +4699,53 @@ function loadPluginConfig(projectDirectory) {
   }
   return config;
 }
+// src/mcp/exa.ts
+var 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
+};
+
+// src/mcp/grep-app.ts
+var grep_app = {
+  type: "remote",
+  url: "https://mcp.grep.app",
+  enabled: true
+};
+
+// src/mcp/sequential-thinking.ts
+var sequentialThinking = {
+  type: "local",
+  command: ["npx", "-y", "@modelcontextprotocol/server-sequential-thinking"],
+  enabled: true
+};
+
+// src/mcp/index.ts
+var allBuiltinMcps = {
+  exa,
+  grep_app,
+  "sequential-thinking": sequentialThinking
+};
+function createBuiltinMcps(disabledMcps = []) {
+  const mcps = {};
+  for (const [name, config] of Object.entries(allBuiltinMcps)) {
+    if (!disabledMcps.includes(name)) {
+      mcps[name] = config;
+    }
+  }
+  return mcps;
+}
+
 // src/index.ts
 var AyushOpenCodePlugin = async (ctx) => {
   const pluginConfig = loadPluginConfig(ctx.directory);
   const disabledAgents = new Set(pluginConfig.disabled_agents ?? []);
+  const disabledMcps = pluginConfig.disabled_mcps ?? [];
   const applyModelOverride = (agentName, baseAgent) => {
     const override = pluginConfig.agents?.[agentName];
     if (override?.model) {
@@ -4725,6 +4776,11 @@ var AyushOpenCodePlugin = async (ctx) => {
         const existingPrompt = config.agent.plan.prompt ?? "";
         config.agent.plan.prompt = existingPrompt + ORCHESTRATION_PROMPT;
       }
+      const builtinMcps = createBuiltinMcps(disabledMcps);
+      config.mcp = {
+        ...config.mcp,
+        ...builtinMcps
+      };
     }
   };
 };

package/dist/mcp/exa.d.ts

@@ -0,0 +1,12 @@
+import type { LocalMcpServerConfig } from "./types";
+/**
+ * Exa MCP Server - Web search and code context
+ *
+ * Provides tools:
+ * - exa_web_search_exa: Web search via Exa AI
+ * - exa_get_code_context_exa: Code context for APIs/libraries
+ * - exa_crawling_exa: URL content extraction
+ *
+ * HTTP Streamable via mcp-remote - No API key required!
+ */
+export declare const exa: LocalMcpServerConfig;

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,10 @@
+import type { RemoteMcpServerConfig } from "./types";
+/**
+ * grep.app MCP Server - GitHub code search
+ *
+ * Provides tools:
+ * - grep_app_searchGitHub: Search real-world code examples from GitHub
+ *
+ * Remote MCP - No API key required!
+ */
+export declare const grep_app: RemoteMcpServerConfig;

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+import type { McpName } from "./types";
+export { McpNameSchema, type McpName } from "./types";
+export type { McpServerConfig, LocalMcpServerConfig, RemoteMcpServerConfig } from "./types";
+/**
+ * Creates the MCP server configurations, excluding any disabled MCPs
+ *
+ * @param disabledMcps - Array of MCP names to disable
+ * @returns Record of enabled MCP server configurations
+ */
+export declare function createBuiltinMcps(disabledMcps?: McpName[]): Record<string, import("./types").LocalMcpServerConfig | import("./types").RemoteMcpServerConfig>;

package/dist/mcp/sequential-thinking.d.ts

@@ -0,0 +1,13 @@
+import type { LocalMcpServerConfig } from "./types";
+/**
+ * Sequential Thinking MCP Server - Structured reasoning
+ *
+ * Provides tools:
+ * - sequential-thinking_sequentialthinking: Dynamic problem-solving through thoughts
+ *
+ * Useful for:
+ * - Breaking down complex problems
+ * - Multi-step planning with revision capability
+ * - Architecture decisions and analysis
+ */
+export declare const sequentialThinking: LocalMcpServerConfig;

package/dist/mcp/types.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/**
+ * MCP Server names that can be configured/disabled
+ */
+export declare const McpNameSchema: z.ZodEnum<["exa", "grep_app", "sequential-thinking"]>;
+export type McpName = z.infer<typeof McpNameSchema>;
+/**
+ * Local MCP server configuration (spawns a process)
+ */
+export interface LocalMcpServerConfig {
+    type: "local";
+    command: string[];
+    enabled: boolean;
+}
+/**
+ * Remote MCP server configuration (connects to URL)
+ */
+export interface RemoteMcpServerConfig {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+}
+/**
+ * Union type for all MCP server configurations
+ */
+export type McpServerConfig = LocalMcpServerConfig | RemoteMcpServerConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ayush-opencode",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Custom OpenCode agents (explorer, librarian, oracle, ui-planner) with orchestration injection for Build/Plan agents",
   "author": "Ayush",
   "license": "MIT",