opencoding-agent 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 j5hjun
+
+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,42 @@
+# opencoding-agent
+
+opencoding-agent is an OpenCode plugin that provides specialized agents and a subagent management system.
+
+## Features
+
+- **Custom Agents**: Replaces default agents with specialized `plan` and `build` modes.
+- **Subagent Catalog**: Browse and install subagents from the [awesome-opencode-subagents](https://github.com/j5hjun/awesome-opencode-subagents) repository.
+
+## Installation
+
+Add this plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": [
+    "opencoding-agent"
+  ]
+}
+```
+
+OpenCode automatically installs plugin dependencies at runtime.
+
+## Tools
+
+- `/subagent-catalog:list`: List available subagent categories.
+- `/subagent-catalog:search <query>`: Search for specific subagents by name or description.
+- `/subagent-catalog:fetch <name> [scope]`: Download and install a subagent (scope: `global` or `local`).
+
+## Development
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To build:
+
+```bash
+bun run build
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./src/index";

package/dist/index.js

@@ -0,0 +1 @@
+export { default } from "./src/index";

package/dist/src/agents/build.d.ts

@@ -0,0 +1,2 @@
+import type { AgentInfo } from "../config";
+export declare const buildAgent: AgentInfo;

package/dist/src/agents/build.js

@@ -0,0 +1,9 @@
+export const buildAgent = {
+    name: "opencoding-build",
+    description: "The default agent. Executes tools based on configured permissions.",
+    mode: "primary",
+    color: "#e74c3c",
+    permission: {
+        "*": "allow"
+    }
+};

package/dist/src/agents/index.d.ts

@@ -0,0 +1 @@
+export declare const injectAgents: (config: any) => Promise<void>;

package/dist/src/agents/index.js

@@ -0,0 +1,24 @@
+import { planAgent } from "./plan";
+import { buildAgent } from "./build";
+export const injectAgents = async (config) => {
+    const planPrompt = await Bun.file(`${import.meta.dir}/../prompts/plan.txt`).text();
+    const buildPrompt = await Bun.file(`${import.meta.dir}/../prompts/build.txt`).text();
+    config.agent = {
+        ...config.agent,
+        // Disable default agents
+        "build": { disable: true },
+        "plan": { disable: true },
+        // Inject our opencoding- prefixed agents
+        "opencoding-plan": {
+            ...planAgent,
+            disable: false,
+            prompt: planPrompt
+        },
+        "opencoding-build": {
+            ...buildAgent,
+            disable: false,
+            prompt: buildPrompt
+        }
+    };
+    config.default_agent = "opencoding-plan";
+};

package/dist/src/agents/plan.d.ts

@@ -0,0 +1,2 @@
+import type { AgentInfo } from "../config";
+export declare const planAgent: AgentInfo;

package/dist/src/agents/plan.js

@@ -0,0 +1,12 @@
+export const planAgent = {
+    name: "opencoding-plan",
+    description: "Plan mode. Disallows all edit tools.",
+    mode: "primary",
+    color: "#3498db",
+    permission: {
+        "*": "allow",
+        "edit": "deny",
+        "write": "deny",
+        "apply_patch": "deny"
+    }
+};

package/dist/src/config.d.ts

@@ -0,0 +1,8 @@
+export type AgentInfo = {
+    name: string;
+    description: string;
+    mode: string;
+    color: string;
+    permission: Record<string, string>;
+};
+export declare const PLUGIN_NAME = "opencoding-agent";

package/dist/src/config.js

@@ -0,0 +1 @@
+export const PLUGIN_NAME = "opencoding-agent";

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * opencoding-agent Plugin
+ *
+ * Replaces default OpenCode agents with core-identical 'plan' and 'build' modes.
+ */
+declare const OpencodingAgentPlugin: Plugin;
+export default OpencodingAgentPlugin;

package/dist/src/index.js

@@ -0,0 +1,20 @@
+import { injectAgents } from "./agents";
+import { catalogTools } from "./tools/catalog";
+/**
+ * opencoding-agent Plugin
+ *
+ * Replaces default OpenCode agents with core-identical 'plan' and 'build' modes.
+ */
+const OpencodingAgentPlugin = async (ctx) => {
+    return {
+        // Config hook: Injected once during initialization
+        config: async (config) => {
+            await injectAgents(config);
+        },
+        // Register custom tools
+        tool: {
+            ...catalogTools
+        }
+    };
+};
+export default OpencodingAgentPlugin;

package/dist/src/tools/catalog.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const catalogTools: {
+    "subagent-catalog:list": {
+        description: string;
+        args: {};
+        execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "subagent-catalog:search": {
+        description: string;
+        args: {
+            query: z.ZodString;
+            category: z.ZodOptional<z.ZodString>;
+        };
+        execute(args: {
+            query: string;
+            category?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "subagent-catalog:fetch": {
+        description: string;
+        args: {
+            name: z.ZodString;
+            scope: z.ZodDefault<z.ZodEnum<{
+                global: "global";
+                local: "local";
+            }>>;
+        };
+        execute(args: {
+            name: string;
+            scope: "global" | "local";
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};

package/dist/src/tools/catalog.js

@@ -0,0 +1,113 @@
+import { tool } from "@opencode-ai/plugin";
+import { z } from "zod";
+import * as path from "path";
+import * as os from "os";
+const REPO_URL = "https://raw.githubusercontent.com/j5hjun/awesome-opencode-subagents/main";
+export const catalogTools = {
+    "subagent-catalog:list": tool({
+        description: "List all available subagent categories and the number of agents in each.",
+        args: {},
+        execute: async () => {
+            try {
+                const url = `${REPO_URL}/catalog.json?t=${Date.now()}`;
+                console.log(`Fetching catalog from: ${url}`);
+                const response = await fetch(url);
+                if (!response.ok) {
+                    const errorMsg = `Fetch failed for ${url}: ${response.status} ${response.statusText}`;
+                    console.error(errorMsg);
+                    return errorMsg;
+                }
+                const catalog = await response.json();
+                const categories = catalog.reduce((acc, item) => {
+                    acc[item.category] = (acc[item.category] || 0) + 1;
+                    return acc;
+                }, {});
+                let output = "Available Subagent Categories:\n\n";
+                for (const [name, count] of Object.entries(categories)) {
+                    output += `- ${name}: ${count} agents\n`;
+                }
+                output += "\nUse subagent-catalog:search to find specific agents.";
+                return output;
+            }
+            catch (error) {
+                return `Error fetching catalog: ${error.message}`;
+            }
+        }
+    }),
+    "subagent-catalog:search": tool({
+        description: "Search for subagents by name, description, or category.",
+        args: {
+            query: z.string().describe("Search term"),
+            category: z.string().optional().describe("Filter by category")
+        },
+        execute: async ({ query, category }) => {
+            try {
+                const url = `${REPO_URL}/catalog.json?t=${Date.now()}`;
+                const response = await fetch(url);
+                if (!response.ok)
+                    return `Fetch failed for ${url}: ${response.status} ${response.statusText}`;
+                const catalog = await response.json();
+                const results = catalog.filter(item => {
+                    const matchesQuery = item.name.toLowerCase().includes(query.toLowerCase()) ||
+                        item.description.toLowerCase().includes(query.toLowerCase());
+                    const matchesCategory = !category || item.category.toLowerCase() === category.toLowerCase();
+                    return matchesQuery && matchesCategory;
+                });
+                if (results.length === 0)
+                    return "No agents found matching your search.";
+                let output = `Search Results for "${query}":\n\n`;
+                for (const item of results) {
+                    output += `### ${item.name}\n`;
+                    output += `**Category**: ${item.category}\n`;
+                    output += `**Description**: ${item.description}\n\n`;
+                }
+                output += "Use subagent-catalog:fetch to install an agent.";
+                return output;
+            }
+            catch (error) {
+                return `Error searching catalog: ${error.message}`;
+            }
+        }
+    }),
+    "subagent-catalog:fetch": tool({
+        description: "Download and install a subagent by name. You can choose to install it globally or locally.",
+        args: {
+            name: z.string().describe("Name of the agent to fetch"),
+            scope: z.enum(["global", "local"]).default("global").describe("Installation scope (global: all projects, local: current project only)")
+        },
+        execute: async ({ name, scope }, { directory }) => {
+            try {
+                const catalogUrl = `${REPO_URL}/catalog.json?t=${Date.now()}`;
+                const catalogResponse = await fetch(catalogUrl);
+                if (!catalogResponse.ok)
+                    return `Fetch failed for ${catalogUrl}: ${catalogResponse.status} ${catalogResponse.statusText}`;
+                const catalog = await catalogResponse.json();
+                const agent = catalog.find(item => item.name.toLowerCase() === name.toLowerCase());
+                if (!agent)
+                    return `Agent "${name}" not found in the catalog.`;
+                const agentUrl = `${REPO_URL}/${agent.path}?t=${Date.now()}`;
+                const agentResponse = await fetch(agentUrl);
+                if (!agentResponse.ok)
+                    return `Fetch failed for ${agentUrl}: ${agentResponse.status} ${agentResponse.statusText}`;
+                const content = await agentResponse.text();
+                let targetDir;
+                if (scope === "global") {
+                    targetDir = path.join(os.homedir(), ".config", "opencode", "agents");
+                }
+                else {
+                    targetDir = path.join(directory, ".opencode", "agents");
+                }
+                const fileName = `${agent.name}.md`;
+                const filePath = path.join(targetDir, fileName);
+                // Ensure directory exists - Bun.write will create the file, but we might need to create the directory
+                const fs = await import("fs/promises");
+                await fs.mkdir(targetDir, { recursive: true });
+                await Bun.write(filePath, content);
+                return `✓ Successfully installed **${agent.name}** to ${scope} path: \`${filePath}\`\n\nYou can now use this agent by saying: "Use the ${agent.name} to [task]"`;
+            }
+            catch (error) {
+                return `Error fetching agent: ${error.message}`;
+            }
+        }
+    })
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "opencoding-agent",
+  "version": "1.0.0",
+  "description": "OpenCode specialized agents and subagent catalog manager",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugin"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.0",
+    "@types/bun": "^1.2.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}