bmm-opencode 1.0.0 → 1.0.1

package/README.md

@@ -9,9 +9,9 @@ BMAD-METHOD agents and skills converted for [OpenCode](https://opencode.ai) - re
 
 ## Installation
 
-### One-Line Install (Recommended)
+### Plugin Install (Recommended)
 
-Simply add `bmm-opencode` to your `opencode.json`:
+Add `bmm-opencode` to your `opencode.json`:
 
 ```json
 {
@@ -20,7 +20,24 @@ Simply add `bmm-opencode` to your `opencode.json`:
 }
 ```
 
-**Done!** Restart OpenCode and all 17 agents + 61 skills are ready to use.
+Restart OpenCode. The plugin provides these tools:
+
+| Tool | Description |
+|------|-------------|
+| `bmm_list` | List all available agents and skills |
+| `bmm_agent` | Get agent definition by name |
+| `bmm_skill` | Get skill instructions by name |
+| `bmm_install` | Copy agents/skills to your project's `.opencode` folder |
+
+### Installing Agents & Skills to Your Project
+
+After adding the plugin, run:
+
+```
+Use the bmm_install tool to install agents and skills
+```
+
+This copies all 17 agents and 61 skills to your project's `.opencode/` directory. Restart OpenCode to use them with Tab switching and slash commands.
 
 ---
 
@@ -49,10 +66,11 @@ rm -rf package bmm-opencode-*.tgz
 
 ## Quick Start
 
-After installation, restart OpenCode and you'll have access to:
+After installation, you have access to:
 
-1. **17 Specialized Agents** - Switch agents using `Tab` key
-2. **61 Workflow Skills** - Load skills via slash commands like `/bmad-bmm-create-prd`
+1. **Plugin Tools** - Use `bmm_list`, `bmm_agent`, `bmm_skill` directly
+2. **17 Specialized Agents** - After `bmm_install`, switch agents using `Tab` key
+3. **61 Workflow Skills** - After `bmm_install`, load skills via slash commands like `/bmad-bmm-create-prd`
 
 ---
 
@@ -125,7 +143,15 @@ After installation, restart OpenCode and you'll have access to:
 
 ## Usage
 
-### Switch to an agent
+### Using Plugin Tools
+
+```
+Use bmm_list to see all available agents and skills
+Use bmm_skill with name bmad-bmm-create-prd to get the PRD creation workflow
+Use bmm_install to copy everything to my project
+```
+
+### Switch to an agent (after bmm_install)
 
 Press `Tab` or use the agent switch keybind, then select an agent.
 

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const BMMPlugin: Plugin;
+export default BMMPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+ClD,eAAO,MAAM,SAAS,EAAE,MA8FvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,127 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { readFileSync, readdirSync, existsSync, cpSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(__dirname, "..");
+const agentsDir = join(packageRoot, ".opencode", "agents");
+const skillsDir = join(packageRoot, ".opencode", "skills");
+function listAgents() {
+    try {
+        return readdirSync(agentsDir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => f.replace(".md", ""));
+    }
+    catch {
+        return [];
+    }
+}
+function listSkills() {
+    try {
+        return readdirSync(skillsDir).filter((d) => existsSync(join(skillsDir, d, "SKILL.md")));
+    }
+    catch {
+        return [];
+    }
+}
+function loadAgent(name) {
+    try {
+        return readFileSync(join(agentsDir, `${name}.md`), "utf-8");
+    }
+    catch {
+        return `Agent "${name}" not found`;
+    }
+}
+function loadSkill(name) {
+    try {
+        return readFileSync(join(skillsDir, name, "SKILL.md"), "utf-8");
+    }
+    catch {
+        return `Skill "${name}" not found`;
+    }
+}
+export const BMMPlugin = async () => {
+    const agents = listAgents();
+    const skills = listSkills();
+    return {
+        tool: {
+            bmm_list: tool({
+                description: "List all available BMAD-METHOD agents and skills from bmm-opencode",
+                args: {},
+                async execute() {
+                    return `# BMM-OpenCode Resources
+
+## Agents (${agents.length})
+${agents.map((a) => `- ${a}`).join("\n")}
+
+## Skills (${skills.length})
+${skills.map((s) => `- ${s}`).join("\n")}
+
+## Usage
+- Use \`bmm_agent\` tool to get agent definition
+- Use \`bmm_skill\` tool to get skill instructions
+- Use \`bmm_install\` tool to copy agents/skills to your project`;
+                },
+            }),
+            bmm_agent: tool({
+                description: "Get a BMAD-METHOD agent definition by name",
+                args: {
+                    name: tool.schema.string().describe(`Agent name`),
+                },
+                async execute(args) {
+                    return loadAgent(args.name);
+                },
+            }),
+            bmm_skill: tool({
+                description: "Get a BMAD-METHOD skill instructions by name",
+                args: {
+                    name: tool.schema.string().describe(`Skill name`),
+                },
+                async execute(args) {
+                    return loadSkill(args.name);
+                },
+            }),
+            bmm_install: tool({
+                description: "Install BMM agents and skills to your project's .opencode directory",
+                args: {
+                    target: tool.schema
+                        .string()
+                        .optional()
+                        .describe("Target directory (defaults to current project)"),
+                },
+                async execute(args, context) {
+                    const targetBase = args.target || join(context.directory, ".opencode");
+                    try {
+                        const targetAgents = join(targetBase, "agents");
+                        const targetSkills = join(targetBase, "skills");
+                        mkdirSync(targetAgents, { recursive: true });
+                        mkdirSync(targetSkills, { recursive: true });
+                        let agentsCopied = 0;
+                        for (const agent of agents) {
+                            const src = join(agentsDir, `${agent}.md`);
+                            const dest = join(targetAgents, `${agent}.md`);
+                            cpSync(src, dest);
+                            agentsCopied++;
+                        }
+                        let skillsCopied = 0;
+                        for (const skill of skills) {
+                            const src = join(skillsDir, skill);
+                            const dest = join(targetSkills, skill);
+                            cpSync(src, dest, { recursive: true });
+                            skillsCopied++;
+                        }
+                        return `Successfully installed BMM-OpenCode to ${targetBase}:
+- ${agentsCopied} agents copied to ${targetAgents}
+- ${skillsCopied} skills copied to ${targetSkills}
+
+Restart OpenCode to use the new agents and skills.`;
+                    }
+                    catch (error) {
+                        return `Installation failed: ${error instanceof Error ? error.message : String(error)}`;
+                    }
+                },
+            }),
+        },
+    };
+};
+export default BMMPlugin;

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "bmm-opencode",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "BMAD-METHOD agents and skills for OpenCode - AI agent framework with 17 specialized agents and 61 workflow skills",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
   "keywords": [
     "opencode",
+    "plugin",
     "bmad",
     "bmad-method",
     "ai-agents",
@@ -25,9 +29,23 @@
   },
   "license": "MIT",
   "author": "Jack-R-Hong",
-  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.51"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
   "files": [
-    ".opencode/**/*"
+    "dist",
+    ".opencode/**/*",
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"