bmm-opencode 1.0.0 → 1.1.0

package/README.md

@@ -9,50 +9,32 @@ BMAD-METHOD agents and skills converted for [OpenCode](https://opencode.ai) - re
 
 ## Installation
 
-### One-Line Install (Recommended)
+### For Humans
 
-Simply add `bmm-opencode` to your `opencode.json`:
+Paste this into your LLM agent session:
 
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["bmm-opencode"]
-}
 ```
-
-**Done!** Restart OpenCode and all 17 agents + 61 skills are ready to use.
-
----
-
-<details>
-<summary><b>Alternative: Manual Installation</b></summary>
-
-#### Via git clone
-
-```bash
-git clone https://github.com/Jack-R-Hong/BMM-opencode.git
-cp -r BMM-opencode/.opencode /path/to/your-project/.opencode
+Install and configure bmm-opencode by following the instructions here:
+https://raw.githubusercontent.com/Jack-R-Hong/BMM-opencode/refs/heads/main/docs/installation.md
 ```
 
-#### Via npm pack
+### For LLM Agents
+
+Fetch the installation guide and follow it:
 
 ```bash
-npm pack bmm-opencode
-tar -xzf bmm-opencode-*.tgz
-cp -r package/.opencode /path/to/your-project/.opencode
-rm -rf package bmm-opencode-*.tgz
+curl -s https://raw.githubusercontent.com/Jack-R-Hong/BMM-opencode/refs/heads/main/docs/installation.md
 ```
 
-</details>
-
 ---
 
 ## 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 +107,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;AAgDlD,eAAO,MAAM,SAAS,EAAE,MAuHvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,154 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { readFileSync, readdirSync, existsSync, cpSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+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\` with \`global=true\` to install globally (~/.config/opencode/)
+- Use \`bmm_install\` to install to current project (.opencode/)`;
+                },
+            }),
+            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. Use global=true for ~/.config/opencode/ (all projects), or omit for current project's .opencode/",
+                args: {
+                    target: tool.schema
+                        .string()
+                        .optional()
+                        .describe("Target directory (defaults to current project's .opencode/)"),
+                    global: tool.schema
+                        .boolean()
+                        .optional()
+                        .describe("Install to global ~/.config/opencode/ instead of project"),
+                    force: tool.schema
+                        .boolean()
+                        .optional()
+                        .describe("Overwrite existing files without warning (default: false)"),
+                },
+                async execute(args, context) {
+                    const globalConfigDir = join(homedir(), ".config", "opencode");
+                    const targetBase = args.global
+                        ? globalConfigDir
+                        : args.target || join(context.directory, ".opencode");
+                    try {
+                        const targetAgents = join(targetBase, "agents");
+                        const targetSkills = join(targetBase, "skills");
+                        const agentsExist = existsSync(targetAgents) && readdirSync(targetAgents).length > 0;
+                        const skillsExist = existsSync(targetSkills) && readdirSync(targetSkills).length > 0;
+                        if ((agentsExist || skillsExist) && !args.force) {
+                            const existing = [];
+                            if (agentsExist)
+                                existing.push(`agents (${readdirSync(targetAgents).length} files)`);
+                            if (skillsExist)
+                                existing.push(`skills (${readdirSync(targetSkills).length} dirs)`);
+                            return `Existing installation detected at ${targetBase}:
+- ${existing.join("\n- ")}
+
+Use \`force=true\` to overwrite, or remove existing files first.`;
+                        }
+                        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++;
+                        }
+                        const installType = args.global ? "globally" : "to project";
+                        return `Successfully installed BMM-OpenCode ${installType} (${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.1.0",
   "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,24 @@
   },
   "license": "MIT",
   "author": "Jack-R-Hong",
-  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules --test tests/*.test.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "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"