@neyugn/agent-kits 0.3.1 → 0.3.3

package/README.md

@@ -47,7 +47,7 @@ Works with **any AI tool** — Claude, Gemini, Codex, Cursor, OpenCode, and more
 ## 🚀 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,14 +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/`      |
-| OpenCode    | `~/.config/opencode/` | `.opencode/` |
-| 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>\`
 
@@ -122,15 +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 |
+| 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     |
+| 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

@@ -479,6 +479,96 @@ 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 {
   /**
@@ -713,7 +803,8 @@ import path5 from "path";
 var OpenCodeInstaller = class {
   // OpenCode uses "commands" instead of "workflows"
   COMMANDS_FOLDER = "commands";
-  // Transformer for OpenCode command format
+  // Transformers for OpenCode-specific formats
+  agentTransformer = createOpenCodeAgentTransformer();
   workflowTransformer = createOpenCodeWorkflowTransformer();
   async install(options) {
     const { aiTool, kits, targetPath } = options;
@@ -725,7 +816,12 @@ var OpenCodeInstaller = class {
       await copyDirectory(
         kitSourcePath,
         kitTargetPath,
-        ["rules", "workflows"],
+        ["rules", "workflows", "agents"],
+        aiTool.path
+      );
+      await this.copyAgentsWithTransform(
+        kitSourcePath,
+        kitTargetPath,
         aiTool.path
       );
       await this.copyWorkflowsWithTransform(
@@ -761,6 +857,46 @@ var OpenCodeInstaller = class {
     }
     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
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neyugn/agent-kits",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Universal AI Agent Toolkit - Skills, Agents, and Workflows for any AI coding assistant",
   "type": "module",
   "bin": {