@neyugn/agent-kits 0.2.8 → 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/>
 
@@ -68,7 +68,7 @@ npx @neyugn/agent-kits
 ```
 
 ```
-  ╭──────────────────────────────────────────────────────────────────────────╮
+  ╭──────────────────────────────────────────────────────────────────────────────╮
   │                                                                          │
   │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
   │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
@@ -78,15 +78,13 @@ npx @neyugn/agent-kits
   │                                                                          │
   │           ⚡  The Universal AI Agent Toolkit  ⚡                         │
   │                                                                          │
-  ╰──────────────────────────────────────────────────────────────────────────╯
+  ╰──────────────────────────────────────────────────────────────────────────────╯
 
   SETUP WIZARD
 
 ◆  🤖 Which AI assistant are you using?
-│  ○ Claude Code (.claude/)
-│  ● Gemini CLI (.gemini/)
+│  ● Antigravity (.agent/)
 │  ○ Cursor (.cursor/)
-│  ○ Custom...
 
 ◆  📂 Where should we install?
 │  ● Workspace (Project)
@@ -108,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>\`
@@ -123,16 +122,17 @@ If the installer detects an existing installation, you'll be prompted:
 
 ### 🔌 Universal Compatibility
 
-| Tool        | Workspace Path    | Global Path  | Status          |
-| ----------- | ----------------- | ------------ | --------------- |
-| Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ Verified     |
-| Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ Verified     |
-| Claude Code | `.claude/skills/` | `~/.claude/` | 🧪 Experimental |
-| Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🧪 Experimental |
-| Codex CLI   | `.codex/skills/`  | `~/.codex/`  | 🧪 Experimental |
-| Custom      | Configurable      | `~/.ai/`     | 🧪 Experimental |
-
-> **Note:** Tools marked as 🧪 Experimental have not been fully tested and may require additional user configuration. Contributions and feedback are welcome!
+| 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.
 
 ### 💻 Cross-Platform Support
 

package/README.vi.md

@@ -60,7 +60,7 @@ npx @neyugn/agent-kits
 ```
 
 ```
-  ╭──────────────────────────────────────────────────────────────────────────╮
+  ╭──────────────────────────────────────────────────────────────────────────────╮
   │                                                                          │
   │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
   │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
@@ -70,15 +70,13 @@ npx @neyugn/agent-kits
   │                                                                          │
   │           ⚡  The Universal AI Agent Toolkit  ⚡                         │
   │                                                                          │
-  ╰──────────────────────────────────────────────────────────────────────────╯
+  ╯──────────────────────────────────────────────────────────────────────────────╯
 
   SETUP WIZARD
 
 ◆  🤖 Bạn đang sử dụng công cụ AI nào?
-│  ○ Claude Code (.claude/)
-│  ● Gemini CLI (.gemini/)
+│  ● Antigravity (.agent/)
 │  ○ Cursor (.cursor/)
-│  ○ Tùy chỉnh...
 
 ◆  📂 Bạn muốn cài đặt ở đâu?
 │  ● Workspace (Dự án hiện tại)
@@ -115,16 +113,16 @@ Nếu installer phát hiện cài đặt đã tồn tại, bạn sẽ được h
 
 ### 🔌 Tương thích phổ quát
 
-| Công cụ     | Đường dẫn Workspace | Đường dẫn Global | Trạng thái     |
-| ----------- | ------------------- | ---------------- | -------------- |
-| Cursor      | `.cursor/skills/`   | `~/.cursor/`     | ✅ Đã xác nhận |
-| Antigravity | `.agent/skills/`    | `~/.agent/`      | ✅ Đã xác nhận |
-| Claude Code | `.claude/skills/`   | `~/.claude/`     | 🧪 Thực nghiệm |
-| Gemini CLI  | `.gemini/skills/`   | `~/.gemini/`     | 🧪 Thực nghiệm |
-| Codex CLI   | `.codex/skills/`    | `~/.codex/`      | 🧪 Thực nghiệm |
-| Tùy chỉnh   | Có thể cấu hình     | `~/.ai/`         | 🧪 Thực nghiệm |
+| Công cụ     | Đường dẫn Workspace | Đường dẫn Global | Trạng thái       |
+| ----------- | ------------------- | ---------------- | ---------------- |
+| Antigravity | `.agent/skills/`    | `~/.agent/`      | ✅ Hỗ trợ đầy đủ |
+| Cursor      | `.cursor/skills/`   | `~/.cursor/`     | ✅ Hỗ trợ đầy đủ |
+| Claude Code | `.claude/skills/`   | `~/.claude/`     | 🔜 Sắp ra mắt    |
+| Gemini CLI  | `.gemini/skills/`   | `~/.gemini/`     | 🔜 Sắp ra mắt    |
+| Codex CLI   | `.codex/skills/`    | `~/.codex/`      | 🔜 Sắp ra mắt    |
+| Tùy chỉnh   | Có thể cấu hình     | `~/.ai/`         | 🔜 Sắp ra mắt    |
 
-> **Lưu ý:** Các công cụ đánh dấu 🧪 Thực nghiệm chưa được kiểm tra đầy đủ và có thể cần người dùng tùy chỉnh thêm. Đóng góp và phản hồi luôn được hoan nghênh!
+> **Lưu ý:** Các công cụ đánh dấu 🔜 Sắp ra mắt đang được lên kế hoạch cho các phiên bản tương lai. Hạ tầng đã sẵn sàng, nhưng các công cụ này cần thêm kiểm tra và cấu hình.
 
 ### 💻 Hỗ trợ đa nền tảng
 

package/README.zh.md

@@ -60,7 +60,7 @@ npx @neyugn/agent-kits
 ```
 
 ```
-  ╭──────────────────────────────────────────────────────────────────────────╮
+  ╭──────────────────────────────────────────────────────────────────────────────╮
   │                                                                          │
   │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
   │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
@@ -70,15 +70,13 @@ npx @neyugn/agent-kits
   │                                                                          │
   │           ⚡  The Universal AI Agent Toolkit  ⚡                         │
   │                                                                          │
-  ╰──────────────────────────────────────────────────────────────────────────╯
+  ╯──────────────────────────────────────────────────────────────────────────────╯
 
   SETUP WIZARD
 
 ◆  🤖 您正在使用哪个 AI 工具？
-│  ○ Claude Code (.claude/)
-│  ● Gemini CLI (.gemini/)
+│  ● Antigravity (.agent/)
 │  ○ Cursor (.cursor/)
-│  ○ 自定义...
 
 ◆  📂 您想安装在哪里？
 │  ● Workspace（当前项目）
@@ -115,16 +113,16 @@ npx @neyugn/agent-kits
 
 ### 🔌 通用兼容性
 
-| 工具        | Workspace 路径    | Global 路径  | 状态      |
-| ----------- | ----------------- | ------------ | --------- |
-| Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ 已验证 |
-| Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ 已验证 |
-| Claude Code | `.claude/skills/` | `~/.claude/` | 🧪 实验性 |
-| Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🧪 实验性 |
-| Codex CLI   | `.codex/skills/`  | `~/.codex/`  | 🧪 实验性 |
-| 自定义      | 可配置            | `~/.ai/`     | 🧪 实验性 |
+| 工具        | Workspace 路径    | Global 路径  | 状态        |
+| ----------- | ----------------- | ------------ | ----------- |
+| Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ 完全支持 |
+| Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ 完全支持 |
+| Claude Code | `.claude/skills/` | `~/.claude/` | 🔜 即将推出 |
+| Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | 🔜 即将推出 |
+| Codex CLI   | `.codex/skills/`  | `~/.codex/`  | 🔜 即将推出 |
+| 自定义      | 可配置            | `~/.ai/`     | 🔜 即将推出 |
 
-> **注意：** 标记为 🧪 实验性的工具尚未完全测试，可能需要用户进行额外配置。欢迎贡献和反馈！
+> **注意：** 标记为 🔜 即将推出的工具已纳入未来版本计划。基础架构已就绪，但这些工具需要额外的测试和配置。
 
 ### 💻 跨平台支持
 

package/dist/cli.js

@@ -4,10 +4,10 @@
 import * as p from "@clack/prompts";
 import boxen from "boxen";
 import figlet from "figlet";
-import fs2 from "fs";
+import fs5 from "fs";
 import gradient from "gradient-string";
 import os2 from "os";
-import path3 from "path";
+import path6 from "path";
 import pc from "picocolors";
 
 // src/config.ts
@@ -33,8 +33,10 @@ var AI_TOOLS = [
     // Resolved to home dir at runtime
     rulesFile: "CLAUDE.md",
     kitRulesFile: "CLAUDE.md",
-    rulesInsideKit: true
+    rulesInsideKit: true,
     // Claude reads from .claude/CLAUDE.md (2025 standard)
+    available: false
+    // Coming soon
   },
   {
     id: "gemini",
@@ -44,8 +46,10 @@ var AI_TOOLS = [
     globalPathPattern: "~/.gemini",
     rulesFile: "GEMINI.md",
     kitRulesFile: "GEMINI.md",
-    rulesInsideKit: true
+    rulesInsideKit: true,
     // Gemini reads from .gemini/GEMINI.md
+    available: false
+    // Coming soon
   },
   {
     id: "codex",
@@ -55,8 +59,10 @@ var AI_TOOLS = [
     globalPathPattern: "~/.codex",
     rulesFile: "AGENTS.md",
     kitRulesFile: "AGENTS.md",
-    rulesInsideKit: true
+    rulesInsideKit: true,
     // Codex reads from .codex/AGENTS.md
+    available: false
+    // Coming soon
   },
   {
     id: "antigravity",
@@ -66,21 +72,39 @@ var AI_TOOLS = [
     globalPathPattern: "~/.agent",
     rulesFile: "GEMINI.md",
     kitRulesFile: "GEMINI.md",
-    rulesInsideKit: true
+    rulesInsideKit: true,
     // Antigravity reads GEMINI.md from inside .agent/
+    available: true
   },
   {
     id: "cursor",
     name: "Cursor",
     icon: "\u26AA",
-    path: ".cursor/rules",
-    // Modern path: .cursor/rules/ (2025 standard)
-    globalPathPattern: "~/.cursor/rules",
-    rulesFile: "rules.md",
+    path: ".cursor",
+    // Base path for Cursor (contains rules/ and commands/)
+    globalPathPattern: "~/.cursor",
+    rulesFile: "rules/rules.md",
     // Modern: .cursor/rules/rules.md instead of .cursorrules
     kitRulesFile: "CURSOR.md",
     // Source file in kit
-    rulesInsideKit: true
+    rulesInsideKit: true,
+    workflowsAs: "commands",
+    // 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",
@@ -89,8 +113,10 @@ var AI_TOOLS = [
     path: ".ai",
     globalPathPattern: "~/.ai",
     rulesFile: "RULES.md",
-    kitRulesFile: "GEMINI.md"
+    kitRulesFile: "GEMINI.md",
     // Use GEMINI.md as base for custom
+    available: false
+    // Coming soon
   }
 ];
 var KITS = [
@@ -136,85 +162,28 @@ var KITS = [
   }
 ];
 
-// src/installers/index.ts
+// src/installers/antigravity.ts
+import fs2 from "fs/promises";
+import path3 from "path";
+
+// src/installers/base.ts
 import fs from "fs/promises";
 import path2 from "path";
 import { fileURLToPath } from "url";
 var __dirname = path2.dirname(fileURLToPath(import.meta.url));
 var KITS_DIR = path2.resolve(__dirname, "../kits");
 var COMMON_DIR = path2.resolve(__dirname, "../common");
-async function installKit(options) {
-  const { aiTool, kits, targetPath } = options;
-  const results = [];
-  for (const kitId of kits) {
-    const kit = KITS.find((k) => k.id === kitId);
-    if (!kit || !kit.available) {
-      throw new Error(`Kit "${kitId}" is not available`);
-    }
-    const kitSourcePath = path2.join(KITS_DIR, kitId);
-    const kitTargetPath = path2.join(targetPath, aiTool.path);
-    await fs.mkdir(kitTargetPath, { recursive: true });
-    await copyDirectory(kitSourcePath, kitTargetPath, ["rules"], aiTool.path);
-    const rulesSource = path2.join(kitSourcePath, "rules", aiTool.kitRulesFile);
-    const rulesTarget = options.scope === "global" || aiTool.rulesInsideKit ? path2.join(kitTargetPath, aiTool.rulesFile) : path2.join(targetPath, aiTool.rulesFile);
-    try {
-      let rulesContent = await fs.readFile(rulesSource, "utf-8");
-      rulesContent = rulesContent.replace(
-        /\.(agent|claude|gemini|cursor|codex)\//g,
-        `${aiTool.path}/`
-      );
-      await fs.writeFile(rulesTarget, rulesContent);
-    } catch {
-      try {
-        const fallbackSource = path2.join(kitSourcePath, "rules", "GEMINI.md");
-        let rulesContent = await fs.readFile(fallbackSource, "utf-8");
-        rulesContent = rulesContent.replace(
-          /\.(agent|claude|gemini|cursor|codex)\//g,
-          `${aiTool.path}/`
-        );
-        await fs.writeFile(rulesTarget, rulesContent);
-      } catch {
-      }
-    }
-    try {
-      const commonSkillsPath = path2.join(COMMON_DIR, "skills");
-      const commonWorkflowsPath = path2.join(COMMON_DIR, "workflows");
-      const commonDocPath = path2.join(COMMON_DIR, "COMMON.md");
-      const targetSkillsPath = path2.join(kitTargetPath, "skills");
-      await fs.mkdir(targetSkillsPath, { recursive: true });
-      await copyDirectory(commonSkillsPath, targetSkillsPath, [], aiTool.path);
-      const targetWorkflowsPath = path2.join(kitTargetPath, "workflows");
-      await fs.mkdir(targetWorkflowsPath, { recursive: true });
-      await copyDirectory(
-        commonWorkflowsPath,
-        targetWorkflowsPath,
-        [],
-        aiTool.path
-      );
-      const targetCommonDoc = path2.join(kitTargetPath, "COMMON.md");
-      const commonContent = await fs.readFile(commonDocPath, "utf-8");
-      const updatedCommonContent = commonContent.replace(
-        /\.(agent|claude|gemini|cursor|codex)\//g,
-        `${aiTool.path}/`
-      );
-      await fs.writeFile(targetCommonDoc, updatedCommonContent);
-    } catch {
-    }
-    const agents = await countItems(path2.join(kitTargetPath, "agents"));
-    const skills = await countItems(path2.join(kitTargetPath, "skills"));
-    const workflows = await countItems(path2.join(kitTargetPath, "workflows"));
-    results.push({
-      kit: kit.name,
-      agents,
-      skills,
-      workflows
-    });
+function getKitSource(kitId) {
+  const kit = KITS.find((k) => k.id === kitId);
+  if (!kit || !kit.available) {
+    throw new Error(`Kit "${kitId}" is not available`);
   }
-  return results;
+  const kitSourcePath = path2.join(KITS_DIR, kitId);
+  return { kitSourcePath, kit };
 }
 function replaceToolPaths(content, targetPath) {
   return content.replace(
-    /\.(agent|claude|gemini|cursor|codex)\//g,
+    /\.(agent|claude|gemini|cursor|codex|opencode)\//g,
     `${targetPath}/`
   );
 }
@@ -250,17 +219,625 @@ async function countItems(dirPath) {
     return 0;
   }
 }
+async function copyRulesFile(kitSourcePath, kitTargetPath, targetPath, aiTool, scope, workflowsReplacement) {
+  const rulesSource = path2.join(kitSourcePath, "rules", aiTool.kitRulesFile);
+  const rulesTarget = scope === "global" || aiTool.rulesInsideKit ? path2.join(kitTargetPath, aiTool.rulesFile) : path2.join(targetPath, aiTool.rulesFile);
+  await fs.mkdir(path2.dirname(rulesTarget), { recursive: true });
+  try {
+    let rulesContent = await fs.readFile(rulesSource, "utf-8");
+    rulesContent = replaceToolPaths(rulesContent, aiTool.path);
+    if (workflowsReplacement) {
+      rulesContent = rulesContent.replace(
+        /workflows\//g,
+        `${workflowsReplacement}/`
+      );
+    }
+    await fs.writeFile(rulesTarget, rulesContent);
+  } catch {
+    try {
+      const fallbackSource = path2.join(kitSourcePath, "rules", "GEMINI.md");
+      let rulesContent = await fs.readFile(fallbackSource, "utf-8");
+      rulesContent = replaceToolPaths(rulesContent, aiTool.path);
+      if (workflowsReplacement) {
+        rulesContent = rulesContent.replace(
+          /workflows\//g,
+          `${workflowsReplacement}/`
+        );
+      }
+      await fs.writeFile(rulesTarget, rulesContent);
+    } catch {
+    }
+  }
+}
+async function copyCommonAssets(kitTargetPath, aiTool, workflowsFolderName = "workflows") {
+  const commonSkillsPath = path2.join(COMMON_DIR, "skills");
+  const commonWorkflowsPath = path2.join(COMMON_DIR, "workflows");
+  const commonDocPath = path2.join(COMMON_DIR, "COMMON.md");
+  const targetSkillsPath = path2.join(kitTargetPath, "skills");
+  await fs.mkdir(targetSkillsPath, { recursive: true });
+  await copyDirectory(commonSkillsPath, targetSkillsPath, [], aiTool.path);
+  const targetWorkflowsPath = path2.join(kitTargetPath, workflowsFolderName);
+  await fs.mkdir(targetWorkflowsPath, { recursive: true });
+  await copyDirectory(
+    commonWorkflowsPath,
+    targetWorkflowsPath,
+    [],
+    aiTool.path
+  );
+  const targetCommonDoc = path2.join(kitTargetPath, "COMMON.md");
+  const commonContent = await fs.readFile(commonDocPath, "utf-8");
+  const updatedCommonContent = replaceToolPaths(commonContent, aiTool.path);
+  await fs.writeFile(targetCommonDoc, updatedCommonContent);
+}
+
+// src/installers/antigravity.ts
+var AntigravityInstaller = class {
+  async install(options) {
+    const { aiTool, kits, targetPath } = options;
+    const results = [];
+    for (const kitId of kits) {
+      const { kitSourcePath, kit } = getKitSource(kitId);
+      const kitTargetPath = path3.join(targetPath, aiTool.path);
+      await fs2.mkdir(kitTargetPath, { recursive: true });
+      await copyDirectory(kitSourcePath, kitTargetPath, ["rules"], aiTool.path);
+      await copyRulesFile(
+        kitSourcePath,
+        kitTargetPath,
+        targetPath,
+        aiTool,
+        options.scope
+      );
+      try {
+        await copyCommonAssets(kitTargetPath, aiTool, "workflows");
+      } catch {
+      }
+      const agents = await countItems(path3.join(kitTargetPath, "agents"));
+      const skills = await countItems(path3.join(kitTargetPath, "skills"));
+      const workflows = await countItems(path3.join(kitTargetPath, "workflows"));
+      results.push({
+        kit: kit.name,
+        agents,
+        skills,
+        workflows
+      });
+    }
+    return results;
+  }
+};
+
+// src/installers/cursor.ts
+import fs3 from "fs/promises";
+import path4 from "path";
+
+// src/transformers/utils.ts
+function parseFrontmatter(content) {
+  const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/;
+  const match = content.match(frontmatterRegex);
+  if (!match) {
+    return {
+      data: {},
+      content,
+      raw: ""
+    };
+  }
+  const rawFrontmatter = match[1];
+  const bodyContent = match[2];
+  const data = {};
+  const lines = rawFrontmatter.split("\n");
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) continue;
+    const key = line.slice(0, colonIndex).trim();
+    let value = line.slice(colonIndex + 1).trim();
+    if (value === "true") value = true;
+    else if (value === "false") value = false;
+    else if (!isNaN(Number(value)) && value !== "") value = Number(value);
+    if (key) {
+      data[key] = value;
+    }
+  }
+  return {
+    data,
+    content: bodyContent,
+    raw: rawFrontmatter
+  };
+}
+function serializeFrontmatter(data) {
+  const lines = ["---"];
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0 || value === null) continue;
+    lines.push(`${key}: ${value}`);
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+function combineMarkdown(frontmatter, content) {
+  return `${frontmatter}
+${content}`;
+}
+
+// src/transformers/cursor-agent.ts
+var CursorAgentTransformer = class {
+  /**
+   * Transform agent content from Agent-Kits format to Cursor subagent format
+   */
+  transform(content, context) {
+    const parsed = parseFrontmatter(content);
+    const originalData = parsed.data;
+    const skillsString = originalData.skills;
+    const skills = skillsString ? skillsString.split(",").map((s) => s.trim()) : [];
+    const cursorFrontmatter = {
+      name: originalData.name,
+      description: originalData.description,
+      model: originalData.model || "inherit",
+      readonly: false,
+      is_background: false
+    };
+    const newFrontmatter = serializeFrontmatter(
+      cursorFrontmatter
+    );
+    let skillsSection = "";
+    if (skills.length > 0) {
+      skillsSection = this.createSkillsSection(
+        skills,
+        context.skillDescriptions || {}
+      );
+    }
+    const bodyContent = parsed.content;
+    const insertedBody = this.insertSkillsSection(bodyContent, skillsSection);
+    return combineMarkdown(newFrontmatter, insertedBody);
+  }
+  /**
+   * Create markdown section for required skills
+   * Uses descriptions from context (loaded from SKILL.md files)
+   */
+  createSkillsSection(skills, skillDescriptions) {
+    const lines = [
+      "",
+      "## \u{1F4DA} Required Skills",
+      "",
+      "This agent uses the following skills from `.cursor/skills/`:",
+      ""
+    ];
+    for (const skill of skills) {
+      const description = skillDescriptions[skill] || "Domain-specific knowledge module";
+      lines.push(`- **${skill}** - ${description}`);
+    }
+    lines.push("", "---", "");
+    return lines.join("\n");
+  }
+  /**
+   * Insert skills section after the first heading
+   */
+  insertSkillsSection(body, skillsSection) {
+    if (!skillsSection) return body;
+    const lines = body.split("\n");
+    let insertIndex = 0;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i].trim();
+      if (line.startsWith("# ")) {
+        insertIndex = i + 1;
+        while (insertIndex < lines.length && lines[insertIndex].trim() === "") {
+          insertIndex++;
+        }
+        if (insertIndex < lines.length && !lines[insertIndex].trim().startsWith("#")) {
+          insertIndex++;
+        }
+        break;
+      }
+    }
+    lines.splice(insertIndex, 0, skillsSection);
+    return lines.join("\n");
+  }
+};
+function createCursorAgentTransformer() {
+  return new CursorAgentTransformer();
+}
+
+// src/transformers/cursor-workflow.ts
+var CursorWorkflowTransformer = class {
+  /**
+   * Transform workflow content from Agent-Kits format to Cursor command format
+   */
+  transform(content, context) {
+    const parsed = parseFrontmatter(content);
+    const originalData = parsed.data;
+    const cursorFrontmatter = {
+      description: originalData.description
+    };
+    const newFrontmatter = serializeFrontmatter(
+      cursorFrontmatter
+    );
+    let bodyContent = parsed.content;
+    bodyContent = this.transformPaths(bodyContent, context);
+    bodyContent = this.transformTerminology(bodyContent);
+    return combineMarkdown(newFrontmatter, bodyContent);
+  }
+  /**
+   * Transform path references from .agent/ to .cursor/
+   */
+  transformPaths(content, context) {
+    let transformed = content;
+    const toolPath = context.aiTool?.path || ".cursor";
+    transformed = transformed.replace(/\.agent\//g, `${toolPath}/`);
+    return transformed;
+  }
+  /**
+   * Transform terminology from Agent-Kits to Cursor
+   */
+  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 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"
+  COMMANDS_FOLDER = "commands";
+  // Transformers for Cursor-specific formats
+  agentTransformer = createCursorAgentTransformer();
+  workflowTransformer = createCursorWorkflowTransformer();
+  async install(options) {
+    const { aiTool, kits, targetPath } = options;
+    const results = [];
+    for (const kitId of kits) {
+      const { kitSourcePath, kit } = getKitSource(kitId);
+      const kitTargetPath = path4.join(targetPath, aiTool.path);
+      await fs3.mkdir(kitTargetPath, { recursive: true });
+      const skillDescriptions = await this.loadSkillDescriptions(kitSourcePath);
+      await copyDirectory(
+        kitSourcePath,
+        kitTargetPath,
+        ["rules", "workflows", "agents"],
+        aiTool.path
+      );
+      await this.copyAgentsWithTransform(
+        kitSourcePath,
+        kitTargetPath,
+        aiTool.path,
+        skillDescriptions
+      );
+      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(path4.join(kitTargetPath, "agents"));
+      const skills = await countItems(path4.join(kitTargetPath, "skills"));
+      const commands = await countItems(
+        path4.join(kitTargetPath, this.COMMANDS_FOLDER)
+      );
+      results.push({
+        kit: kit.name,
+        agents,
+        skills,
+        workflows: commands
+        // Still called "workflows" in result for consistency
+      });
+    }
+    return results;
+  }
+  /**
+   * Load skill descriptions from SKILL.md files
+   *
+   * Reads the `description` field from each skill's frontmatter.
+   * Loads from both kit-specific skills and common skills.
+   *
+   * @returns Map of skill name to description
+   */
+  async loadSkillDescriptions(kitSourcePath) {
+    const descriptions = {};
+    const kitSkillsPath = path4.join(kitSourcePath, "skills");
+    await this.extractSkillDescriptions(kitSkillsPath, descriptions);
+    const commonSkillsPath = path4.join(COMMON_DIR, "skills");
+    await this.extractSkillDescriptions(commonSkillsPath, descriptions);
+    return descriptions;
+  }
+  /**
+   * Extract descriptions from all SKILL.md files in a directory
+   */
+  async extractSkillDescriptions(skillsDir, descriptions) {
+    try {
+      const entries = await fs3.readdir(skillsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const skillMdPath = path4.join(skillsDir, entry.name, "SKILL.md");
+        try {
+          const content = await fs3.readFile(skillMdPath, "utf-8");
+          const parsed = parseFrontmatter(content);
+          if (parsed.data.description) {
+            let desc = String(parsed.data.description);
+            const sentenceEnd = desc.indexOf(". ");
+            if (sentenceEnd > 0 && sentenceEnd < 80) {
+              desc = desc.slice(0, sentenceEnd);
+            } else if (desc.length > 80) {
+              desc = desc.slice(0, 77) + "...";
+            }
+            descriptions[entry.name] = desc;
+          }
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  /**
+   * Copy agents with transformation to Cursor subagent format
+   *
+   * This method:
+   * 1. Reads each agent file from the kit
+   * 2. Transforms the frontmatter to Cursor subagent format
+   * 3. Embeds skills references into the agent body
+   * 4. Writes the transformed agent to the target directory
+   */
+  async copyAgentsWithTransform(kitSourcePath, kitTargetPath, toolPath, skillDescriptions) {
+    const agentsSource = path4.join(kitSourcePath, "agents");
+    const agentsTarget = path4.join(kitTargetPath, "agents");
+    try {
+      await fs3.access(agentsSource);
+    } catch {
+      return;
+    }
+    await fs3.mkdir(agentsTarget, { recursive: true });
+    const entries = await fs3.readdir(agentsSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".md")) {
+        continue;
+      }
+      const sourcePath = path4.join(agentsSource, entry.name);
+      const targetPath = path4.join(agentsTarget, entry.name);
+      let content = await fs3.readFile(sourcePath, "utf-8");
+      content = replaceToolPaths(content, toolPath);
+      const context = {
+        aiTool: { path: toolPath },
+        sourcePath,
+        targetPath,
+        skillDescriptions
+      };
+      const transformedContent = this.agentTransformer.transform(
+        content,
+        context
+      );
+      await fs3.writeFile(targetPath, transformedContent);
+    }
+  }
+  /**
+   * Copy workflows with transformation to Cursor command format
+   *
+   * This method:
+   * 1. Reads each workflow file from the kit
+   * 2. Transforms the frontmatter to Cursor command format
+   * 3. Replaces path references (.agent/ -> .cursor/)
+   * 4. Replaces terminology (workflow -> command)
+   * 5. Writes the transformed command to the commands directory
+   */
+  async copyWorkflowsWithTransform(kitSourcePath, kitTargetPath, toolPath) {
+    const workflowsSource = path4.join(kitSourcePath, "workflows");
+    const commandsTarget = path4.join(kitTargetPath, this.COMMANDS_FOLDER);
+    try {
+      await fs3.access(workflowsSource);
+    } catch {
+      return;
+    }
+    await fs3.mkdir(commandsTarget, { recursive: true });
+    const entries = await fs3.readdir(workflowsSource, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".md")) {
+        continue;
+      }
+      const sourcePath = path4.join(workflowsSource, entry.name);
+      const targetPath = path4.join(commandsTarget, entry.name);
+      const content = await fs3.readFile(sourcePath, "utf-8");
+      const context = {
+        aiTool: { path: toolPath },
+        sourcePath,
+        targetPath
+      };
+      const transformedContent = this.workflowTransformer.transform(
+        content,
+        context
+      );
+      await fs3.writeFile(targetPath, transformedContent);
+    }
+  }
+};
+
+// 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
+  antigravity: new AntigravityInstaller(),
+  // These tools use the same installation logic as Antigravity
+  claude: new AntigravityInstaller(),
+  gemini: new AntigravityInstaller(),
+  codex: new AntigravityInstaller(),
+  custom: new AntigravityInstaller(),
+  // Cursor has special handling (workflows -> commands)
+  cursor: new CursorInstaller(),
+  // OpenCode has special handling (workflows -> commands, AGENTS.md at root)
+  opencode: new OpenCodeInstaller()
+};
+function getInstaller(toolId) {
+  const installer = installerRegistry[toolId];
+  if (!installer) {
+    return new AntigravityInstaller();
+  }
+  return installer;
+}
+async function installKit(options) {
+  const installer = getInstaller(options.aiTool.id);
+  return installer.install(options);
+}
 
 // src/cli.ts
 function expandPath(inputPath) {
   if (inputPath.startsWith("~")) {
-    return path3.join(os2.homedir(), inputPath.slice(1));
+    return path6.join(os2.homedir(), inputPath.slice(1));
   }
   return inputPath;
 }
 function directoryExists(dirPath) {
   try {
-    return fs2.existsSync(dirPath) && fs2.statSync(dirPath).isDirectory();
+    return fs5.existsSync(dirPath) && fs5.statSync(dirPath).isDirectory();
   } catch {
     return false;
   }
@@ -269,7 +846,7 @@ function getInstallPath(aiTool, scope, workspacePath) {
   if (scope === "global") {
     return getGlobalPath(aiTool);
   }
-  return path3.join(workspacePath, aiTool.path);
+  return path6.join(workspacePath, aiTool.path);
 }
 function getDisplayPath(absolutePath) {
   const home = os2.homedir();
@@ -307,7 +884,7 @@ async function main() {
   p.intro(pc.bgCyan(pc.black(" SETUP WIZARD ")));
   const aiToolResult = await p.select({
     message: "\u{1F916} Which AI assistant are you using?",
-    options: AI_TOOLS.map((tool) => ({
+    options: AI_TOOLS.filter((tool) => tool.available).map((tool) => ({
       value: tool.id,
       label: `${tool.name}`,
       hint: `${getGlobalPathDisplay(tool)}`
@@ -324,7 +901,7 @@ async function main() {
       {
         value: "workspace",
         label: "Workspace (Project)",
-        hint: `Best for sharing with team (${path3.join(process.cwd(), aiTool.path)})`
+        hint: `Best for sharing with team (${path6.join(process.cwd(), aiTool.path)})`
       },
       {
         value: "global",
@@ -359,7 +936,7 @@ async function main() {
     workspacePath = expandPath(pathResult);
   }
   const finalInstallPath = getInstallPath(aiTool, scope, workspacePath);
-  const rulesFilePath = scope === "global" || aiTool.rulesInsideKit ? path3.join(finalInstallPath, aiTool.rulesFile) : path3.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))}`
@@ -400,7 +977,7 @@ async function main() {
     if (replaceResult === "replace") {
       const s_rm = p.spinner();
       s_rm.start("Cleaning up old files...");
-      fs2.rmSync(finalInstallPath, { recursive: true, force: true });
+      fs5.rmSync(finalInstallPath, { recursive: true, force: true });
       s_rm.stop("Cleanup complete.");
     }
   }

package/kits/coder/rules/CURSOR.md

@@ -1,9 +1,10 @@
 ---
-description: AGT-Kit - AI Agent system rules with 22 agents, 39 skills, 7 workflows
+trigger: always_on
+description: AGT-Kit - AI Agent system rules with 22 agents, 39 skills, 7 commands
 alwaysApply: true
 ---
 
-# GEMINI.md - AGT-Kit
+# CURSOR Rules - AGT-Kit
 
 > AI Agent Capability Expansion Toolkit - This file defines AI behavior in this workspace.
 
@@ -15,7 +16,7 @@ AGT-Kit is a portable, modular AI agent system consisting of:
 
 - **22 Specialist Agents** - Role-based AI personas
 - **39 Skills** - Domain-specific knowledge modules
-- **7 Workflows** - Slash command procedures
+- **7 Commands** - Slash command procedures
 
 ---
 
@@ -118,7 +119,9 @@ Agent activated → Check frontmatter `skills:` → Read SKILL.md → Apply.
 
 ---
 
-## 📜 WORKFLOWS (Slash Commands)
+## 📜 COMMANDS (Slash Commands)
+
+> **Note:** In Cursor, workflows are called "commands" and stored in `.cursor/commands/`
 
 | Command        | Description                          | Agent           |
 | -------------- | ------------------------------------ | --------------- |
@@ -139,10 +142,10 @@ User Request → Check Profile → Skill Description Match → Load SKILL.md →
 
 ### Profile-Aware Loading
 
-> **CRITICAL:** Before loading any skill or selecting any agent, check `.agent/profile.json`
+> **CRITICAL:** Before loading any skill or selecting any agent, check `.cursor/profile.json`
 
 ```
-1. Check if `.agent/profile.json` exists
+1. Check if `.cursor/profile.json` exists
 2. If EXISTS:
    - Read skills.enabled[] → Only load these skills
    - Read skills.disabled[] → Skip these skills
@@ -190,7 +193,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
 
 > 🔴 Read `ARCHITECTURE.md` at session start.
 
-**Paths:** Agents `.agent/agents/`, Skills `.agent/skills/`, Workflows `.agent/workflows/`
+**Paths:** Agents `.cursor/agents/`, Skills `.cursor/skills/`, Commands `.cursor/commands/`
 
 ### 🧠 Read → Understand → Apply
 
@@ -297,12 +300,12 @@ python3 .agent/scripts/skills_manager.py search <query>
 
 ## 📊 Kit Statistics
 
-| Metric    | Count |
-| --------- | ----- |
-| Agents    | 22    |
-| Skills    | 39    |
-| Workflows | 7     |
-| Scripts   | 19    |
+| Metric   | Count |
+| -------- | ----- |
+| Agents   | 22    |
+| Skills   | 39    |
+| Commands | 7     |
+| Scripts  | 19    |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neyugn/agent-kits",
-  "version": "0.2.8",
+  "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"