bmm-opencode 1.0.1 → 1.1.0

package/README.md

@@ -9,59 +9,23 @@ BMAD-METHOD agents and skills converted for [OpenCode](https://opencode.ai) - re
 
 ## Installation
 
-### Plugin Install (Recommended)
+### For Humans
 
-Add `bmm-opencode` to your `opencode.json`:
+Paste this into your LLM agent session:
 
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["bmm-opencode"]
-}
 ```
-
-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
+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
 ```
 
-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.
-
----
-
-<details>
-<summary><b>Alternative: Manual Installation</b></summary>
+### For LLM Agents
 
-#### Via git clone
+Fetch the installation guide and follow it:
 
 ```bash
-git clone https://github.com/Jack-R-Hong/BMM-opencode.git
-cp -r BMM-opencode/.opencode /path/to/your-project/.opencode
+curl -s https://raw.githubusercontent.com/Jack-R-Hong/BMM-opencode/refs/heads/main/docs/installation.md
 ```
 
-#### Via npm pack
-
-```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
-```
-
-</details>
-
 ---
 
 ## Quick Start

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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

@@ -2,6 +2,7 @@ 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");
@@ -60,7 +61,8 @@ ${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`;
+- Use \`bmm_install\` with \`global=true\` to install globally (~/.config/opencode/)
+- Use \`bmm_install\` to install to current project (.opencode/)`;
                 },
             }),
             bmm_agent: tool({
@@ -82,18 +84,42 @@ ${skills.map((s) => `- ${s}`).join("\n")}
                 },
             }),
             bmm_install: tool({
-                description: "Install BMM agents and skills to your project's .opencode directory",
+                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)"),
+                        .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 targetBase = args.target || join(context.directory, ".opencode");
+                    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;
@@ -110,7 +136,8 @@ ${skills.map((s) => `- ${s}`).join("\n")}
                             cpSync(src, dest, { recursive: true });
                             skillsCopied++;
                         }
-                        return `Successfully installed BMM-OpenCode to ${targetBase}:
+                        const installType = args.global ? "globally" : "to project";
+                        return `Successfully installed BMM-OpenCode ${installType} (${targetBase}):
 - ${agentsCopied} agents copied to ${targetAgents}
 - ${skillsCopied} skills copied to ${targetSkills}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmm-opencode",
-  "version": "1.0.1",
+  "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",
@@ -32,7 +32,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "test": "node --experimental-vm-modules --test tests/*.test.js",
+    "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
     "@opencode-ai/plugin": "^1.1.51"