@neyugn/agent-kits 0.3.0 → 0.3.2

package/README.md

@@ -40,14 +40,14 @@
 - 📜 **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/>
 
 ## 🚀 Quick Start
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 That's it! The interactive installer will guide you through:
@@ -64,7 +64,7 @@ That's it! The interactive installer will guide you through:
 ### 🎯 One Command, Any Tool
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 ```
@@ -100,13 +100,14 @@ npx @neyugn/agent-kits
 
 **Global Paths by Tool:**
 
-| Tool        | Global Path  | Workspace Path |
-| ----------- | ------------ | -------------- |
-| Claude Code | `~/.claude/` | `.claude/`     |
-| Gemini CLI  | `~/.gemini/` | `.gemini/`     |
-| Codex CLI   | `~/.codex/`  | `.codex/`      |
-| Antigravity | `~/.agent/`  | `.agent/`      |
-| Cursor      | `~/.cursor/` | `.cursor/`     |
+| Tool        | Global Path           | Workspace Path |
+| ----------- | --------------------- | -------------- |
+| Claude Code | `~/.claude/`          | `.claude/`     |
+| 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>\`
 
@@ -121,14 +122,15 @@ If the installer detects an existing installation, you'll be prompted:
 
 ### 🔌 Universal Compatibility
 
-| Tool        | Workspace Path    | Global Path  | Status             |
-| ----------- | ----------------- | ------------ | ------------------ |
-| Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ Fully Supported |
-| Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ Fully Supported |
-| Claude Code | `.claude/skills/` | `~/.claude/` | 🔜 Coming Soon     |
-| Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🔜 Coming Soon     |
-| Codex CLI   | `.codex/skills/`  | `~/.codex/`  | 🔜 Coming Soon     |
-| Custom      | Configurable      | `~/.ai/`     | 🔜 Coming Soon     |
+| 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     |
+| Codex CLI   | `.codex/skills/`  | `~/.codex/`           | 🔜 Coming Soon     |
+| Custom      | Configurable      | `~/.ai/`              | 🔜 Coming Soon     |
 
 > **Note:** Tools marked as 🔜 Coming Soon are planned for future releases. The infrastructure is ready, but these tools require additional testing and configuration.
 

package/README.vi.md

@@ -39,7 +39,7 @@ Hoạt động với **mọi công cụ AI** — Claude, Gemini, Codex, Cursor,
 ## 🚀 Bắt đầu nhanh
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 Đó là tất cả! Installer tương tác sẽ hướng dẫn bạn:
@@ -56,7 +56,7 @@ npx @neyugn/agent-kits
 ### 🎯 Một lệnh, mọi công cụ
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 ```

package/README.zh.md

@@ -39,7 +39,7 @@
 ## 🚀 快速开始
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 就这样！交互式安装程序将引导您：
@@ -56,7 +56,7 @@ npx @neyugn/agent-kits
 ### 🎯 一条命令，任何工具
 
 ```bash
-npx @neyugn/agent-kits
+npx @neyugn/agent-kits@latest
 ```
 
 ```

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,139 @@ function createCursorWorkflowTransformer() {
   return new CursorWorkflowTransformer();
 }
 
+// src/transformers/opencode-agent.ts
+var TOOL_NAME_MAP = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  bash: "bash",
+  grep: "grep",
+  glob: "glob",
+  agent: "agent"
+};
+var OpenCodeAgentTransformer = class {
+  /**
+   * Transform agent content from Agent-Kits format to OpenCode agent format
+   */
+  transform(content, context) {
+    const parsed = parseFrontmatter(content);
+    const originalData = parsed.data;
+    const toolsRecord = this.parseToolsToRecord(originalData.tools);
+    const opencodeFrontmatter = {
+      description: originalData.description,
+      ...originalData.model && { model: originalData.model },
+      ...Object.keys(toolsRecord).length > 0 && { tools: toolsRecord }
+    };
+    const newFrontmatter = this.serializeOpenCodeFrontmatter(opencodeFrontmatter);
+    let bodyContent = parsed.content;
+    bodyContent = this.transformPaths(bodyContent, context);
+    return combineMarkdown(newFrontmatter, bodyContent);
+  }
+  /**
+   * Parse comma-separated tools string into a record of { toolName: boolean }
+   *
+   * @example
+   * "Read, Grep, Glob, Bash, Edit, Write" →
+   * { read: true, grep: true, glob: true, bash: true, edit: true, write: true }
+   */
+  parseToolsToRecord(toolsString) {
+    if (!toolsString) return {};
+    const tools = {};
+    const toolNames = toolsString.split(",").map((t) => t.trim().toLowerCase());
+    for (const toolName of toolNames) {
+      const mappedName = TOOL_NAME_MAP[toolName] || toolName;
+      tools[mappedName] = true;
+    }
+    return tools;
+  }
+  /**
+   * Custom serializer for OpenCode frontmatter
+   *
+   * OpenCode expects tools as a nested YAML map:
+   * ```yaml
+   * tools:
+   *   read: true
+   *   write: true
+   * ```
+   *
+   * The standard serializeFrontmatter outputs flat key-value pairs,
+   * so we need custom handling for the `tools` field.
+   */
+  serializeOpenCodeFrontmatter(data) {
+    const lines = ["---"];
+    if (data.description) {
+      lines.push(`description: ${data.description}`);
+    }
+    if (data.model) {
+      lines.push(`model: ${data.model}`);
+    }
+    if (data.mode) {
+      lines.push(`mode: ${data.mode}`);
+    }
+    if (data.tools && Object.keys(data.tools).length > 0) {
+      lines.push("tools:");
+      for (const [tool, enabled] of Object.entries(data.tools)) {
+        lines.push(`  ${tool}: ${enabled}`);
+      }
+    }
+    lines.push("---");
+    return lines.join("\n");
+  }
+  /**
+   * Replace .agent/ paths with .opencode/
+   */
+  transformPaths(content, context) {
+    const toolPath = context.aiTool?.path || ".opencode";
+    return content.replace(/\.agent\//g, `${toolPath}/`);
+  }
+};
+function createOpenCodeAgentTransformer() {
+  return new OpenCodeAgentTransformer();
+}
+
+// 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 +797,147 @@ 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";
+  // Transformers for OpenCode-specific formats
+  agentTransformer = createOpenCodeAgentTransformer();
+  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", "agents"],
+        aiTool.path
+      );
+      await this.copyAgentsWithTransform(
+        kitSourcePath,
+        kitTargetPath,
+        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 agents with transformation to OpenCode format
+   *
+   * This method:
+   * 1. Reads each agent file from the kit
+   * 2. Replaces tool path references (.agent/ → .opencode/)
+   * 3. Transforms the frontmatter `tools` field from string to record
+   * 4. Removes unnecessary fields (name, skills, tier)
+   * 5. Writes the transformed agent to the target directory
+   */
+  async copyAgentsWithTransform(kitSourcePath, kitTargetPath, toolPath) {
+    const agentsSource = path5.join(kitSourcePath, "agents");
+    const agentsTarget = path5.join(kitTargetPath, "agents");
+    try {
+      await fs4.access(agentsSource);
+    } catch {
+      return;
+    }
+    await fs4.mkdir(agentsTarget, { recursive: true });
+    const entries = await fs4.readdir(agentsSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".md")) {
+        continue;
+      }
+      const sourcePath = path5.join(agentsSource, entry.name);
+      const targetPath = path5.join(agentsTarget, entry.name);
+      let content = await fs4.readFile(sourcePath, "utf-8");
+      content = replaceToolPaths(content, toolPath);
+      const context = {
+        aiTool: { path: toolPath },
+        sourcePath,
+        targetPath
+      };
+      const transformedContent = this.agentTransformer.transform(
+        content,
+        context
+      );
+      await fs4.writeFile(targetPath, transformedContent);
+    }
+  }
+  /**
+   * 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 +948,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 +967,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 +982,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 +1037,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 +1072,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 +1113,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.2",
   "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"