@neyugn/agent-kits 0.3.0 → 0.3.1

package/README.md

@@ -40,7 +40,7 @@
 - 📜 **Workflows** — Slash commands for common tasks
 - 🔍 **Smart Filtering** — Auto-detect techstack and optimize loaded skills
 
-Works with **any AI tool** — Claude, Gemini, Codex, Cursor, and more.
+Works with **any AI tool** — Claude, Gemini, Codex, Cursor, OpenCode, and more.
 
 <br/>
 
@@ -106,6 +106,7 @@ npx @neyugn/agent-kits
 | Gemini CLI  | `~/.gemini/` | `.gemini/`     |
 | Codex CLI   | `~/.codex/`  | `.codex/`      |
 | Antigravity | `~/.agent/`  | `.agent/`      |
+| OpenCode    | `~/.config/opencode/` | `.opencode/` |
 | Cursor      | `~/.cursor/` | `.cursor/`     |
 
 > **Note:** On Windows, `~` is replaced with `C:\Users\<username>\`
@@ -124,6 +125,7 @@ If the installer detects an existing installation, you'll be prompted:
 | Tool        | Workspace Path    | Global Path  | Status             |
 | ----------- | ----------------- | ------------ | ------------------ |
 | Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ Fully Supported |
+| OpenCode    | `.opencode/`      | `~/.config/opencode/` | ✅ Fully Supported |
 | Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ Fully Supported |
 | Claude Code | `.claude/skills/` | `~/.claude/` | 🔜 Coming Soon     |
 | Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🔜 Coming Soon     |

package/dist/cli.js

@@ -4,10 +4,10 @@
 import * as p from "@clack/prompts";
 import boxen from "boxen";
 import figlet from "figlet";
-import fs4 from "fs";
+import fs5 from "fs";
 import gradient from "gradient-string";
 import os2 from "os";
-import path5 from "path";
+import path6 from "path";
 import pc from "picocolors";
 
 // src/config.ts
@@ -92,6 +92,20 @@ var AI_TOOLS = [
     // Cursor calls workflows "commands" in .cursor/commands/
     available: true
   },
+  {
+    id: "opencode",
+    name: "OpenCode",
+    icon: "\u232C",
+    path: ".opencode",
+    globalPathPattern: "~/.config/opencode",
+    rulesFile: "AGENTS.md",
+    kitRulesFile: "AGENTS.md",
+    rulesInsideKit: false,
+    // OpenCode reads AGENTS.md from project root
+    workflowsAs: "commands",
+    // OpenCode calls workflows "commands" in .opencode/commands/
+    available: true
+  },
   {
     id: "custom",
     name: "Custom",
@@ -169,7 +183,7 @@ function getKitSource(kitId) {
 }
 function replaceToolPaths(content, targetPath) {
   return content.replace(
-    /\.(agent|claude|gemini|cursor|codex)\//g,
+    /\.(agent|claude|gemini|cursor|codex|opencode)\//g,
     `${targetPath}/`
   );
 }
@@ -465,6 +479,49 @@ function createCursorWorkflowTransformer() {
   return new CursorWorkflowTransformer();
 }
 
+// src/transformers/opencode-workflow.ts
+var OpenCodeWorkflowTransformer = class {
+  /**
+   * Transform workflow content from Agent-Kits format to OpenCode command format
+   */
+  transform(content, context) {
+    const parsed = parseFrontmatter(content);
+    const originalData = parsed.data;
+    const commandFrontmatter = {
+      description: String(originalData.description || "")
+    };
+    const newFrontmatter = serializeFrontmatter(
+      commandFrontmatter
+    );
+    let bodyContent = parsed.content;
+    bodyContent = this.transformPaths(bodyContent, context);
+    bodyContent = this.transformTerminology(bodyContent);
+    return combineMarkdown(newFrontmatter, bodyContent);
+  }
+  /**
+   * Replace .agent/ paths with .opencode/
+   */
+  transformPaths(content, context) {
+    const toolPath = context.aiTool?.path || ".opencode";
+    return content.replace(/\.agent\//g, `${toolPath}/`);
+  }
+  /**
+   * Transform terminology: workflow → command
+   */
+  transformTerminology(content) {
+    let transformed = content;
+    transformed = transformed.replace(/workflows?\//gi, "commands/");
+    transformed = transformed.replace(/\/workflow/gi, "/command");
+    transformed = transformed.replace(/workflow/gi, "command");
+    transformed = transformed.replace(/Workflow/g, "Command");
+    transformed = transformed.replace(/WORKFLOW/g, "COMMAND");
+    return transformed;
+  }
+};
+function createOpenCodeWorkflowTransformer() {
+  return new OpenCodeWorkflowTransformer();
+}
+
 // src/installers/cursor.ts
 var CursorInstaller = class {
   // Cursor uses "commands" instead of "workflows"
@@ -650,6 +707,101 @@ var CursorInstaller = class {
   }
 };
 
+// src/installers/opencode.ts
+import fs4 from "fs/promises";
+import path5 from "path";
+var OpenCodeInstaller = class {
+  // OpenCode uses "commands" instead of "workflows"
+  COMMANDS_FOLDER = "commands";
+  // Transformer for OpenCode command format
+  workflowTransformer = createOpenCodeWorkflowTransformer();
+  async install(options) {
+    const { aiTool, kits, targetPath } = options;
+    const results = [];
+    for (const kitId of kits) {
+      const { kitSourcePath, kit } = getKitSource(kitId);
+      const kitTargetPath = path5.join(targetPath, aiTool.path);
+      await fs4.mkdir(kitTargetPath, { recursive: true });
+      await copyDirectory(
+        kitSourcePath,
+        kitTargetPath,
+        ["rules", "workflows"],
+        aiTool.path
+      );
+      await this.copyWorkflowsWithTransform(
+        kitSourcePath,
+        kitTargetPath,
+        aiTool.path
+      );
+      await copyRulesFile(
+        kitSourcePath,
+        kitTargetPath,
+        targetPath,
+        aiTool,
+        options.scope,
+        this.COMMANDS_FOLDER
+        // Replace workflows/ with commands/
+      );
+      try {
+        await copyCommonAssets(kitTargetPath, aiTool, this.COMMANDS_FOLDER);
+      } catch {
+      }
+      const agents = await countItems(path5.join(kitTargetPath, "agents"));
+      const skills = await countItems(path5.join(kitTargetPath, "skills"));
+      const commands = await countItems(
+        path5.join(kitTargetPath, this.COMMANDS_FOLDER)
+      );
+      results.push({
+        kit: kit.name,
+        agents,
+        skills,
+        workflows: commands
+        // Still called "workflows" in result for consistency
+      });
+    }
+    return results;
+  }
+  /**
+   * Copy workflows with transformation to OpenCode command format
+   *
+   * This method:
+   * 1. Reads each workflow file from the kit
+   * 2. Transforms the frontmatter to OpenCode command format
+   * 3. Replaces path references (.agent/ → .opencode/)
+   * 4. Replaces terminology (workflow → command)
+   * 5. Writes the transformed command to the commands directory
+   */
+  async copyWorkflowsWithTransform(kitSourcePath, kitTargetPath, toolPath) {
+    const workflowsSource = path5.join(kitSourcePath, "workflows");
+    const commandsTarget = path5.join(kitTargetPath, this.COMMANDS_FOLDER);
+    try {
+      await fs4.access(workflowsSource);
+    } catch {
+      return;
+    }
+    await fs4.mkdir(commandsTarget, { recursive: true });
+    const entries = await fs4.readdir(workflowsSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".md")) {
+        continue;
+      }
+      const sourcePath = path5.join(workflowsSource, entry.name);
+      const targetPath = path5.join(commandsTarget, entry.name);
+      const content = await fs4.readFile(sourcePath, "utf-8");
+      const context = {
+        aiTool: { path: toolPath },
+        sourcePath,
+        targetPath
+      };
+      const transformedContent = this.workflowTransformer.transform(
+        content,
+        context
+      );
+      await fs4.writeFile(targetPath, transformedContent);
+    }
+  }
+};
+
 // src/installers/index.ts
 var installerRegistry = {
   // Antigravity is the base/default installer
@@ -660,7 +812,9 @@ var installerRegistry = {
   codex: new AntigravityInstaller(),
   custom: new AntigravityInstaller(),
   // Cursor has special handling (workflows -> commands)
-  cursor: new CursorInstaller()
+  cursor: new CursorInstaller(),
+  // OpenCode has special handling (workflows -> commands, AGENTS.md at root)
+  opencode: new OpenCodeInstaller()
 };
 function getInstaller(toolId) {
   const installer = installerRegistry[toolId];
@@ -677,13 +831,13 @@ async function installKit(options) {
 // src/cli.ts
 function expandPath(inputPath) {
   if (inputPath.startsWith("~")) {
-    return path5.join(os2.homedir(), inputPath.slice(1));
+    return path6.join(os2.homedir(), inputPath.slice(1));
   }
   return inputPath;
 }
 function directoryExists(dirPath) {
   try {
-    return fs4.existsSync(dirPath) && fs4.statSync(dirPath).isDirectory();
+    return fs5.existsSync(dirPath) && fs5.statSync(dirPath).isDirectory();
   } catch {
     return false;
   }
@@ -692,7 +846,7 @@ function getInstallPath(aiTool, scope, workspacePath) {
   if (scope === "global") {
     return getGlobalPath(aiTool);
   }
-  return path5.join(workspacePath, aiTool.path);
+  return path6.join(workspacePath, aiTool.path);
 }
 function getDisplayPath(absolutePath) {
   const home = os2.homedir();
@@ -747,7 +901,7 @@ async function main() {
       {
         value: "workspace",
         label: "Workspace (Project)",
-        hint: `Best for sharing with team (${path5.join(process.cwd(), aiTool.path)})`
+        hint: `Best for sharing with team (${path6.join(process.cwd(), aiTool.path)})`
       },
       {
         value: "global",
@@ -782,7 +936,7 @@ async function main() {
     workspacePath = expandPath(pathResult);
   }
   const finalInstallPath = getInstallPath(aiTool, scope, workspacePath);
-  const rulesFilePath = scope === "global" || aiTool.rulesInsideKit ? path5.join(finalInstallPath, aiTool.rulesFile) : path5.join(workspacePath, aiTool.rulesFile);
+  const rulesFilePath = scope === "global" || aiTool.rulesInsideKit ? path6.join(finalInstallPath, aiTool.rulesFile) : path6.join(workspacePath, aiTool.rulesFile);
   if (directoryExists(finalInstallPath)) {
     p.log.warn(
       `${pc.yellow("\u26A0")} Existing toolkit found at: ${pc.cyan(getDisplayPath(finalInstallPath))}`
@@ -823,7 +977,7 @@ async function main() {
     if (replaceResult === "replace") {
       const s_rm = p.spinner();
       s_rm.start("Cleaning up old files...");
-      fs4.rmSync(finalInstallPath, { recursive: true, force: true });
+      fs5.rmSync(finalInstallPath, { recursive: true, force: true });
       s_rm.stop("Cleanup complete.");
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neyugn/agent-kits",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Universal AI Agent Toolkit - Skills, Agents, and Workflows for any AI coding assistant",
   "type": "module",
   "bin": {
@@ -20,6 +20,7 @@
     "codex",
     "cursor",
     "copilot",
+    "opencode",
     "workflow",
     "prompt",
     "toolkit"