opencode-agent-kit 1.0.1 → 1.0.3

package/bin/commands/init.mjs

@@ -1,19 +1,26 @@
-import { readFileSync, existsSync, copyFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
+import {
+  readFileSync,
+  existsSync,
+  copyFileSync,
+  mkdirSync,
+  writeFileSync,
+  readdirSync,
+} from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const PKG_ROOT = join(__dirname, '..', '..');
-const TEMPLATE_DIR = join(PKG_ROOT, 'template');
+const PKG_ROOT = join(__dirname, "..", "..");
+const TEMPLATE_DIR = join(PKG_ROOT, "template");
 
 function copyRecursive(src, dest) {
   if (!existsSync(src)) return;
   const entries = readdirSync(src, { withFileTypes: true });
   mkdirSync(dest, { recursive: true });
   for (const entry of entries) {
-    if (entry.name === '.DS_Store') continue;
+    if (entry.name === ".DS_Store") continue;
     const srcPath = join(src, entry.name);
     const destPath = join(dest, entry.name);
     if (entry.isDirectory()) {
@@ -25,10 +32,10 @@ function copyRecursive(src, dest) {
 }
 
 function detectPackageManager(cwd) {
-  if (existsSync(join(cwd, 'bun.lock'))) return 'bun';
-  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
-  if (existsSync(join(cwd, 'yarn.lock'))) return 'yarn';
-  return 'npm';
+  if (existsSync(join(cwd, "bun.lock"))) return "bun";
+  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
 }
 
 function mergeJson(target, source, strategy = {}) {
@@ -40,19 +47,19 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    const rule = strategy[key] || 'default';
+    const rule = strategy[key] || "default";
 
-    if (rule === 'keep-target') {
+    if (rule === "keep-target") {
       // Keep user's existing value
       continue;
     }
 
-    if (rule === 'source-wins') {
+    if (rule === "source-wins") {
       merged[key] = JSON.parse(JSON.stringify(value));
       continue;
     }
 
-    if (rule === 'merge-agents') {
+    if (rule === "merge-agents") {
       merged[key] = merged[key] || {};
       for (const [agentKey, agentVal] of Object.entries(value)) {
         if (!(agentKey in merged[key])) {
@@ -63,7 +70,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-mcp') {
+    if (rule === "merge-mcp") {
       merged[key] = merged[key] || {};
       for (const [mcpKey, mcpVal] of Object.entries(value)) {
         if (!(mcpKey in merged[key])) {
@@ -73,7 +80,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-instructions') {
+    if (rule === "merge-instructions") {
       const existing = merged[key] || [];
       const srcArr = Array.isArray(value) ? value : [value];
       for (const item of srcArr) {
@@ -85,7 +92,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-permissions') {
+    if (rule === "merge-permissions") {
       merged[key] = merged[key] || {};
       for (const [permKey, permVal] of Object.entries(value)) {
         if (!(permKey in merged[key])) {
@@ -96,8 +103,14 @@ function mergeJson(target, source, strategy = {}) {
     }
 
     // default: source wins for top-level, but merge nested objects
-    if (typeof value === 'object' && value !== null && !Array.isArray(value) &&
-        typeof merged[key] === 'object' && merged[key] !== null && !Array.isArray(merged[key])) {
+    if (
+      typeof value === "object" &&
+      value !== null &&
+      !Array.isArray(value) &&
+      typeof merged[key] === "object" &&
+      merged[key] !== null &&
+      !Array.isArray(merged[key])
+    ) {
       merged[key] = { ...merged[key], ...value };
     } else {
       merged[key] = value;
@@ -108,19 +121,19 @@ function mergeJson(target, source, strategy = {}) {
 }
 
 function mergeOencodeConfig(templateConfigPath, userConfigPath, force) {
-  const templateConfig = JSON.parse(readFileSync(templateConfigPath, 'utf-8'));
+  const templateConfig = JSON.parse(readFileSync(templateConfigPath, "utf-8"));
   const userConfig = existsSync(userConfigPath)
-    ? JSON.parse(readFileSync(userConfigPath, 'utf-8'))
+    ? JSON.parse(readFileSync(userConfigPath, "utf-8"))
     : {};
 
   const strategy = {
-    '$schema': 'source-wins',
-    'formatter': 'keep-target',
-    'permission': 'keep-target',
-    'instructions': 'merge-instructions',
-    'mcp': 'merge-mcp',
-    'agent': force ? 'source-wins' : 'merge-agents',
-    'plugin': 'merge-instructions',
+    $schema: "source-wins",
+    formatter: "keep-target",
+    permission: "keep-target",
+    instructions: "merge-instructions",
+    mcp: "merge-mcp",
+    agent: force ? "source-wins" : "merge-agents",
+    plugin: "merge-instructions",
   };
 
   const merged = mergeJson(userConfig, templateConfig, strategy);
@@ -141,16 +154,21 @@ export async function init(options) {
   }
 
   // 2. Check if .opencode already exists
-  const opencodeDir = join(targetDir, '.opencode');
-  const userConfigPath = join(targetDir, 'opencode.json');
+  const opencodeDir = join(targetDir, ".opencode");
+  const userConfigPath = join(targetDir, "opencode.json");
 
   if (existsSync(opencodeDir) && !force) {
     console.log(`  \n  ⚠  .opencode/ already exists in ${targetDir}`);
-    const rl = await import('readline/promises');
-    const readline = rl.createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await readline.question(`  ? Overwrite existing files? [y/N] `);
+    const rl = await import("readline/promises");
+    const readline = rl.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    const answer = await readline.question(
+      `  ? Overwrite existing files? [y/N] `,
+    );
     readline.close();
-    if (answer.toLowerCase() !== 'y') {
+    if (answer.toLowerCase() !== "y") {
       console.log(`  ✗ Aborted.`);
       process.exit(0);
     }
@@ -165,50 +183,43 @@ export async function init(options) {
 
   // 4. Copy .opencode/ from template
   console.log(`  \n  📁 Copying .opencode/ configuration...`);
-  copyRecursive(join(TEMPLATE_DIR, '.opencode'), opencodeDir);
+  copyRecursive(join(TEMPLATE_DIR, ".opencode"), opencodeDir);
 
   // 5. Merge opencode.json
-  const templateConfigPath = join(TEMPLATE_DIR, 'opencode.json');
+  const templateConfigPath = join(TEMPLATE_DIR, "opencode.json");
   if (existsSync(templateConfigPath)) {
     console.log(`  📝 Merging opencode.json...`);
-    const merged = mergeOencodeConfig(templateConfigPath, userConfigPath, force);
-    writeFileSync(userConfigPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+    const merged = mergeOencodeConfig(
+      templateConfigPath,
+      userConfigPath,
+      force,
+    );
+    writeFileSync(
+      userConfigPath,
+      JSON.stringify(merged, null, 2) + "\n",
+      "utf-8",
+    );
   }
 
-  // 6. Handle AGENTS.md (append)
-  const templateAgentsPath = join(TEMPLATE_DIR, 'AGENTS.md');
-  const userAgentsPath = join(targetDir, 'AGENTS.md');
-  if (existsSync(templateAgentsPath)) {
-    const templateContent = readFileSync(templateAgentsPath, 'utf-8');
-    if (existsSync(userAgentsPath) && !force) {
-      const existingContent = readFileSync(userAgentsPath, 'utf-8');
-      if (!existingContent.includes('# opencode-agent-kit')) {
-        console.log(`  📄 Appending to existing AGENTS.md...`);
-        writeFileSync(userAgentsPath, existingContent.trimEnd() + '\n\n' + templateContent, 'utf-8');
-      }
-    } else {
-      console.log(`  📄 Writing AGENTS.md...`);
-      writeFileSync(userAgentsPath, templateContent, 'utf-8');
-    }
-  }
-
-  // 7. Install dependencies
+  // 6. Install dependencies
   if (!skipInstall) {
     const pm = detectPackageManager(opencodeDir);
     console.log(`  📦 Installing .opencode/ dependencies with ${pm}...`);
     try {
-      execSync(`${pm} install`, { cwd: opencodeDir, stdio: 'pipe' });
+      execSync(`${pm} install`, { cwd: opencodeDir, stdio: "pipe" });
     } catch (err) {
       console.error(`  ⚠  Dependency install failed: ${err.message}`);
       console.error(`    You can run "${pm} install" manually in .opencode/`);
     }
   }
 
-  // 8. Done
+  // 7. Done
   console.log(`\n  ✅ opencode-agent-kit installed!\n`);
   console.log(`     Location: ${targetDir}`);
   console.log(`     What you got:`);
-  console.log(`       • opencode.json        — 13 agents config with MCP servers`);
+  console.log(
+    `       • opencode.json        — 13 agents config with MCP servers`,
+  );
   console.log(`       • .opencode/agents/    — 14 agent prompt files`);
   console.log(`       • .opencode/skills/    — 60+ skill playbooks`);
   console.log(`       • .opencode/commands/  — 35+ slash commands`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO) with 62 skills, 36 commands, and 6 MCP servers",
   "type": "module",
   "bin": {

package/template/opencode.json

@@ -1,6 +1,5 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "formatter": true,
   "permission": {
     "read": {
       "*": "allow",
@@ -31,60 +30,10 @@
     ".opencode/skills/security-review/SKILL.md",
     ".opencode/skills/frontend-design/SKILL.md"
   ],
-  "mcp": {
-    "nuxt": {
-      "type": "remote",
-      "url": "https://nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt documentation, blog posts, and deployment guides"
-    },
-    "nuxt-ui": {
-      "type": "remote",
-      "url": "https://ui.nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt UI component documentation and examples"
-    },
-    "figma": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-figma"],
-      "env": {
-        "FIGMA_ACCESS_TOKEN": "${FIGMA_ACCESS_TOKEN}"
-      },
-      "enabled": false,
-      "description": "Figma design file access (requires FIGMA_ACCESS_TOKEN)"
-    },
-    "playwright": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-playwright"],
-      "enabled": true,
-      "description": "Browser automation and E2E testing with Playwright"
-    },
-    "stitch": {
-      "type": "remote",
-      "url": "https://stitch.googleapis.com/mcp",
-      "headers": {
-        "X-Goog-Api-Key": "${STITCH_API_KEY}"
-      },
-      "enabled": false,
-      "description": "Google Stitch AI design generation (requires STITCH_API_KEY)"
-    },
-    "postman": {
-      "type": "remote",
-      "url": "https://mcp.postman.com/mcp",
-      "headers": {
-        "Authorization": "Bearer ${POSTMAN_API_KEY}"
-      },
-      "enabled": true,
-      "description": "Postman API management for collections, requests, and documentation"
-    }
-  },
   "agent": {
     "leader": {
       "description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",
       "mode": "primary",
-      "model": "opencode/claude-opus-4.5",
       "prompt": "{file:.opencode/agents/it-leader.md}",
       "temperature": 0.4,
       "color": "#8b5cf6",
@@ -111,7 +60,6 @@
     "frontend-nuxt": {
       "description": "Expert Vue/Nuxt frontend developer for Nuxt.js, Vue 3, Nuxt UI, and modern web technologies with MCP integration (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/nuxt-frontend-developer.md}",
       "color": "#3b82f6",
       "permission": {
@@ -135,7 +83,6 @@
     "frontend-react": {
       "description": "Expert React/Next.js frontend developer for React 19, Next.js 15, Vite, shadcn/ui, and modern web technologies (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/react-frontend-developer.md}",
       "color": "#06b6d4",
       "permission": {
@@ -157,7 +104,6 @@
     "backend": {
       "description": "Expert backend developer for Node.js, Express, Prisma, and PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/node-backend-developer.md}",
       "color": "#10b981",
       "permission": {
@@ -177,7 +123,6 @@
     "ci3": {
       "description": "CodeIgniter 3 MVC fullstack developer for REST API, JWT, MySQL/PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/code-igniter-3-fullstack.md}",
       "color": "#84cc16",
       "permission": {
@@ -196,7 +141,6 @@
     "laravel": {
       "description": "Laravel backend engineer for REST API, Service/Repository, JWT, MySQL/PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/laravel-advanced.md}",
       "color": "#f97316",
       "permission": {
@@ -215,7 +159,6 @@
     "designer": {
       "description": "UI/UX Designer specializing in design systems, Google Stitch, Figma, accessibility, and design-to-code handoff (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4",
       "prompt": "{file:.opencode/agents/ui-ux-designer.md}",
       "color": "#f59e0b",
       "permission": {
@@ -236,7 +179,6 @@
     "reviewer": {
       "description": "Code Reviewer & QA Engineer specializing in code quality, security audit, testing strategy, and verification (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-opus-4.5",
       "prompt": "{file:.opencode/agents/code-reviewer.md}",
       "color": "#ef4444",
       "permission": {
@@ -257,7 +199,6 @@
     "database": {
       "description": "Database Specialist specializing in PostgreSQL schema design, query optimization, Prisma ORM, and migrations (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/database-specialist.md}",
       "color": "#06b6d4",
       "permission": {
@@ -276,7 +217,6 @@
     "devops": {
       "description": "DevOps Engineer specializing in CI/CD, deployment, Docker, monitoring, and infrastructure (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-haiku-4.5",
       "prompt": "{file:.opencode/agents/devops-specialist.md}",
       "color": "#6366f1",
       "permission": {
@@ -296,7 +236,6 @@
     "seo": {
       "description": "SEO Specialist specializing in meta tags, structured data, Core Web Vitals, and content optimization (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/gpt-5.1-codex-mini",
       "prompt": "{file:.opencode/agents/seo-specialist.md}",
       "color": "#84cc16",
       "permission": {
@@ -315,7 +254,6 @@
     "android": {
       "description": "Expert Android developer for Kotlin, Jetpack Compose, XML, Material Design 3, and Google Play (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/android-developer.md}",
       "color": "#22c55e",
       "permission": {
@@ -334,7 +272,6 @@
     "flutter": {
       "description": "Expert Flutter developer for Dart, Flutter SDK, Material Design 3, Firebase, and cross-platform mobile apps (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/flutter-developer.md}",
       "color": "#0284c7",
       "permission": {

package/template/AGENTS.md

@@ -1,32 +0,0 @@
-# opencode-agent-kit
-
-Multi-stack agent toolkit installed by `opencode-agent-kit`.
-
-## Agents
-
-| Agent | Type | Description |
-|-------|------|-------------|
-| `leader` | primary | IT Leader — orchestrates subagents via task tool |
-| `@frontend-nuxt` | subagent | Nuxt 4 + Vue 3 + TypeScript |
-| `@frontend-react` | subagent | React 19 + Next.js 15 + shadcn/ui |
-| `@backend` | subagent | Node.js + Express + Prisma + PostgreSQL |
-| `@ci3` | subagent | CodeIgniter 3 MVC monolith |
-| `@laravel` | subagent | Laravel 10+ REST API + Service Layer |
-| `@designer` | subagent | UI/UX — design system, Figma, Stitch |
-| `@reviewer` | subagent | Code quality, security audit, testing |
-| `@database` | subagent | PostgreSQL, Prisma, migrations |
-| `@devops` | subagent | CI/CD, Docker, monitoring |
-| `@seo` | subagent | Meta tags, Core Web Vitals, structured data |
-| `@android` | subagent | Kotlin, Jetpack Compose, Google Play |
-| `@flutter` | subagent | Dart, Flutter SDK, Firebase |
-
-## Slash Commands
-
-`/plan`, `/tdd`, `/code-review`, `/security`, `/build-fix`, `/e2e`, `/refactor-clean`
-`/orchestrate`, `/update-docs`, `/test-coverage`
-`/android-build`, `/android-test`, `/gpc-release`
-`/flutter-build`, `/flutter-test`
-
-## MCP Servers
-
-Nuxt docs, Nuxt UI, Playwright, Postman (enabled). Figma, Stitch (disabled, set env vars to enable).