opencode-agent-kit 1.0.19 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 defuj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/commands/doctor.mjs

@@ -0,0 +1,164 @@
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+const PKG_NAME = 'opencode-agent-kit';
+
+function check(condition, passMsg, failMsg) {
+  if (condition) {
+    console.log(`  ✓ ${passMsg}`);
+    return true;
+  }
+  console.log(`  ✗ ${failMsg}`);
+  return false;
+}
+
+function warn(msg) {
+  console.log(`  ⚠ ${msg}`);
+}
+
+export async function doctor(options) {
+  const targetDir = options.dir || process.cwd();
+  const { fix } = options;
+
+  console.log(`\n  ${PKG_NAME} doctor`);
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  Target: ${targetDir}\n`);
+
+  let allGood = true;
+
+  // 1. Check Node.js version
+  const nodeVersion = process.version;
+  const major = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+  allGood &= check(
+    major >= 18,
+    `Node.js ${nodeVersion} (>= 18)`,
+    `Node.js ${nodeVersion} — need >= 18`,
+  );
+
+  // 2. Check package.json exists
+  const pkgPath = join(targetDir, 'package.json');
+  allGood &= check(
+    existsSync(pkgPath),
+    'package.json found',
+    'package.json not found',
+  );
+
+  // 3. Check opencode.json
+  const configPath = join(targetDir, 'opencode.json');
+  const hasConfig = existsSync(configPath);
+  allGood &= check(hasConfig, 'opencode.json found', 'opencode.json not found');
+
+  if (hasConfig) {
+    try {
+      JSON.parse(readFileSync(configPath, 'utf-8'));
+      check(true, 'opencode.json is valid JSON', '');
+    } catch {
+      allGood = false;
+      console.log('  ✗ opencode.json is not valid JSON');
+    }
+  }
+
+  // 4. Check .opencode directory
+  const opencodeDir = join(targetDir, '.opencode');
+  const hasOpencode = existsSync(opencodeDir);
+  allGood &= check(hasOpencode, '.opencode/ directory found', '.opencode/ directory not found');
+
+  if (hasOpencode) {
+    // 4a. Check agents
+    const agentsDir = join(opencodeDir, 'agents');
+    check(
+      existsSync(agentsDir),
+      '.opencode/agents/ found',
+      '.opencode/agents/ missing',
+    );
+
+    // 4b. Check instructions
+    const instrDir = join(opencodeDir, 'instructions');
+    check(
+      existsSync(instrDir),
+      '.opencode/instructions/ found',
+      '.opencode/instructions/ missing',
+    );
+
+    // 4c. Check skills
+    const skillsDir = join(opencodeDir, 'skills');
+    check(
+      existsSync(skillsDir),
+      '.opencode/skills/ found',
+      '.opencode/skills/ missing',
+    );
+
+    // 4d. Count agents
+    if (existsSync(agentsDir)) {
+      const agents = readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+      check(
+        agents.length >= 10,
+        `${agents.length} agent prompts found (expected 14)`,
+        `Only ${agents.length} agent prompts found (expected 14)`,
+      );
+    }
+
+    // 4e. Check kit-version
+    const versionFile = join(opencodeDir, '.kit-version');
+    if (existsSync(versionFile)) {
+      const installedVersion = readFileSync(versionFile, 'utf-8').trim();
+      try {
+        const latest = execSync(`npm view ${PKG_NAME} version`, {
+          encoding: 'utf-8',
+          timeout: 5000,
+        }).trim();
+        if (installedVersion !== latest) {
+          warn(`Kit v${installedVersion} installed, v${latest} available`);
+          if (fix) {
+            console.log('     → Run `npx opencode-agent-kit upgrade` to update');
+          }
+        } else {
+          check(true, `Kit version v${installedVersion} (up to date)`, '');
+        }
+      } catch {
+        warn('Could not check latest version (npm registry unreachable)');
+      }
+    } else {
+      warn('.kit-version not found');
+    }
+  }
+
+  // 5. Check .gitignore
+  const gitignorePath = join(targetDir, '.gitignore');
+  if (existsSync(gitignorePath)) {
+    const content = readFileSync(gitignorePath, 'utf-8');
+    check(
+      content.includes('.opencode') || content.includes('opencode.json'),
+      '.gitignore covers .opencode/ files',
+      '.gitignore may not cover .opencode/ files',
+    );
+  } else {
+    warn('.gitignore not found');
+    if (fix) {
+      console.log('     → Run `opencode-agent-kit init` to create one');
+    }
+  }
+
+  // 6. Check global agentmemory
+  try {
+    execSync('agentmemory --version', { stdio: 'pipe', timeout: 3000 });
+    check(true, 'agentmemory (global) is installed', '');
+  } catch {
+    warn('agentmemory not installed globally');
+    if (fix) {
+      console.log('     → Run: npm install -g @agentmemory/agentmemory');
+    }
+  }
+
+  // Summary
+  console.log(`\n  ${'─'.repeat(50)}`);
+  if (allGood) {
+    console.log(`\n  ✅ All checks passed. Your setup looks good!\n`);
+  } else {
+    console.log(`\n  ⚠  Some checks failed. Review the issues above.\n`);
+    if (!fix) {
+      console.log(`  Tip: Run with --fix to enable actionable suggestions.\n`);
+    }
+  }
+}

package/bin/commands/init.mjs

@@ -6,15 +6,43 @@ import {
   writeFileSync,
   readdirSync,
   appendFileSync,
-} from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { execSync } from "child_process";
+} 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');
+const PKG_NAME = 'opencode-agent-kit';
+
+// ANSI colors
+const C = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  bold: '\x1b[1m',
+};
+
+function info(msg) {
+  console.log(`  ${C.cyan}→${C.reset} ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  ${C.green}✓${C.reset} ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  ${C.yellow}⚠${C.reset} ${msg}`);
+}
+
+function error(msg) {
+  console.log(`  ${C.red}✗${C.reset} ${msg}`);
+}
 
 function copyRecursive(src, dest) {
   if (!existsSync(src)) return;
@@ -146,157 +174,130 @@ export async function init(options) {
   const force = options.force;
   const skipInstall = options.skipInstall;
 
-  console.log(`\n  opencode-agent-kit init`);
+  console.log(`\n  ${C.bold}${PKG_NAME} init${C.reset}`);
+  console.log(`  ${C.dim}${'─'.repeat(50)}${C.reset}`);
 
   // 1. Validate target
   if (!existsSync(targetDir)) {
     console.error(`  ✗ Target directory does not exist: ${targetDir}`);
+    error(`Target directory does not exist: ${targetDir}`);
     process.exit(1);
   }
 
   // 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");
+    warn(`.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 answer = await readline.question(`  ? Overwrite existing files? [y/N] `);
     readline.close();
-    if (answer.toLowerCase() !== "y") {
-      console.log(`  ✗ Aborted.`);
+    if (answer.toLowerCase() !== 'y') {
+      error('Aborted.');
       process.exit(0);
     }
   }
 
   // 3. Validate template exists
   if (!existsSync(TEMPLATE_DIR)) {
-    console.error(`  ✗ Template directory not found at ${TEMPLATE_DIR}`);
-    console.error(`    This is a bug. Please reinstall the package.`);
+    error(`Template directory not found at ${TEMPLATE_DIR}`);
+    error('This is a bug. Please reinstall the package.');
     process.exit(1);
   }
 
   // 4. Copy .opencode/ from template
-  console.log(`  \n  📁 Copying .opencode/ configuration...`);
-  copyRecursive(join(TEMPLATE_DIR, ".opencode"), opencodeDir);
+  info('Copying .opencode/ configuration...');
+  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",
-    );
+    info('Merging opencode.json...');
+    const merged = mergeOencodeConfig(templateConfigPath, userConfigPath, force);
+    writeFileSync(userConfigPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
   }
 
   // 6. Copy opencode.example.json
-  const exampleSrc = join(TEMPLATE_DIR, "opencode.example.json");
-  const exampleDest = join(targetDir, "opencode.example.json");
+  const exampleSrc = join(TEMPLATE_DIR, 'opencode.example.json');
+  const exampleDest = join(targetDir, 'opencode.example.json');
   if (existsSync(exampleSrc)) {
-    console.log(`  📄 Copying opencode.example.json...`);
+    info('Copying opencode.example.json...');
     copyFileSync(exampleSrc, exampleDest);
   }
 
   // 7. Install dependencies
   if (!skipInstall) {
     const pm = detectPackageManager(opencodeDir);
-    console.log(`  📦 Installing .opencode/ dependencies with ${pm}...`);
+    info(`Installing .opencode/ dependencies with ${pm}...`);
     try {
-      execSync(`${pm} install`, { cwd: opencodeDir, stdio: "pipe" });
+      execSync(`${pm} install`, { cwd: opencodeDir, stdio: 'pipe' });
+      success('.opencode/ dependencies installed');
     } catch (err) {
-      console.error(`  ⚠  Dependency install failed: ${err.message}`);
-      console.error(`    You can run "${pm} install" manually in .opencode/`);
+      warn(`Dependency install failed: ${err.message}`);
+      warn(`You can run "${pm} install" manually in .opencode/`);
     }
   }
 
-  // 7.6 Install agentmemory globally
+  // 8. Install agentmemory globally
   if (!skipInstall) {
-    console.log(`  🧠 Installing agentmemory (persistent memory)...`);
+    info('Setting up agentmemory (persistent memory)...');
     try {
-      execSync(`agentmemory --version`, { stdio: "pipe" });
-      console.log(`     ✓ agentmemory already installed`);
+      execSync('agentmemory --version', { stdio: 'pipe' });
+      success('agentmemory already installed');
     } catch {
       try {
-        execSync(`npm install -g @agentmemory/agentmemory`, {
-          stdio: "pipe",
+        execSync('npm install -g @agentmemory/agentmemory', {
+          stdio: 'pipe',
           timeout: 60000,
         });
-        console.log(`     ✓ agentmemory installed globally`);
+        success('agentmemory installed globally');
       } catch (err) {
-        console.error(`  ⚠  agentmemory global install failed: ${err.message}`);
-        console.error(
-          `    Run "npm install -g @agentmemory/agentmemory" manually`,
-        );
+        warn(`agentmemory global install failed: ${err.message}`);
+        warn('Run "npm install -g @agentmemory/agentmemory" manually');
       }
     }
   }
 
-  // 8. Update .gitignore
-  const gitignorePath = join(targetDir, ".gitignore");
-  const gitignoreEntries = [
-    ".opencode/*",
-    "opencode.json",
-    "opencode.example.json",
-    "data/",
-  ];
+  // 9. Update .gitignore
+  const gitignorePath = join(targetDir, '.gitignore');
+  const gitignoreEntries = ['.opencode/*', 'opencode.json', 'opencode.example.json', 'data/'];
   if (!existsSync(gitignorePath)) {
-    writeFileSync(gitignorePath, gitignoreEntries.join("\n") + "\n", "utf-8");
-    console.log(`  📄 Created .gitignore...`);
+    writeFileSync(gitignorePath, gitignoreEntries.join('\n') + '\n', 'utf-8');
+    success('Created .gitignore');
   } else {
-    const gitignoreContent = readFileSync(gitignorePath, "utf-8");
+    const gitignoreContent = readFileSync(gitignorePath, 'utf-8');
     let appended = false;
     for (const entry of gitignoreEntries) {
       if (!gitignoreContent.includes(entry)) {
-        appendFileSync(gitignorePath, entry + "\n", "utf-8");
+        appendFileSync(gitignorePath, entry + '\n', 'utf-8');
         appended = true;
       }
     }
-    if (appended) {
-      console.log(`  📄 Updated .gitignore...`);
-    }
+    if (appended) success('Updated .gitignore');
   }
 
-  // 9. Write .kit-version for agent update checking
-  const pkgJson = JSON.parse(
-    readFileSync(join(PKG_ROOT, "package.json"), "utf-8"),
-  );
-  const versionFile = join(opencodeDir, ".kit-version");
-  writeFileSync(versionFile, pkgJson.version + "\n", "utf-8");
-
-  // 10. Done
-  console.log(`\n  ✅ opencode-agent-kit v${pkgJson.version} installed!\n`);
-  console.log(`     Location: ${targetDir}`);
-  console.log(`     What you got:`);
-  console.log(
-    `       • opencode.json              — 13 agents config with MCP servers`,
-  );
-  console.log(
-    `       • opencode.example.json      — Example config for reference`,
-  );
-  console.log(`       • .opencode/agents    — 14 agent prompt files`);
-  console.log(`       • .opencode/skills/    — 60+ skill playbooks`);
-  console.log(`       • .opencode/commands/  — 35+ slash commands`);
-  console.log(`       • .opencode/rules/     — Scoped coding rules`);
-  console.log(`       • .opencode/contexts/  — Dev/review/research contexts`);
-  console.log(`       • .opencode/docs/     — Agent documentation`);
-  console.log(`       • .opencode/plugins/  — agentmemory capture plugin (22 hooks)`);
-  console.log(`       • .opencode/hooks/    — agentmemory auto-start wrapper`);
-  console.log(`       • agentmemory (global) — Persistent cross-session memory`);
-  console.log(`\n     Next steps:`);
-  console.log(`       cd ${targetDir}`);
-  console.log(`       opencode              # agentmemory auto-starts on first use`);
-  console.log(`       # Viewer: http://localhost:3113`);
+  // 10. Write .kit-version for agent update checking
+  const pkgJson = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf-8'));
+  const versionFile = join(opencodeDir, '.kit-version');
+  writeFileSync(versionFile, pkgJson.version + '\n', 'utf-8');
+
+  // 11. Done — summary
+  console.log(`\n  ${C.bold}${C.green}✅ opencode-agent-kit v${pkgJson.version} installed!${C.reset}\n`);
+  console.log(`  ${C.dim}Location:${C.reset} ${targetDir}`);
+  console.log(`  ${C.dim}${'─'.repeat(30)}${C.reset}`);
+  console.log(`  ${C.bold}What you got:${C.reset}`);
+  console.log(`    • ${C.cyan}opencode.json${C.reset}          — 13 agents + MCP servers`);
+  console.log(`    • ${C.cyan}.opencode/agents/${C.reset}      — 14 agent prompt files`);
+  console.log(`    • ${C.cyan}.opencode/skills/${C.reset}      — 60+ skill playbooks`);
+  console.log(`    • ${C.cyan}.opencode/commands/${C.reset}    — 35+ slash commands`);
+  console.log(`    • ${C.cyan}.opencode/rules/${C.reset}       — Scoped coding rules`);
+  console.log(`    • ${C.cyan}.opencode/hooks/${C.reset}       — Automation hooks`);
+  console.log(`    • ${C.cyan}.opencode/docs/${C.reset}        — Agent documentation`);
+  console.log(`    • ${C.cyan}agentmemory${C.reset} (global)  — Persistent memory`);
+  console.log(`\n  ${C.bold}${C.green}→${C.reset} Next step: run ${C.cyan}opencode${C.reset} to start\n`);
 }

package/bin/commands/uninstall.mjs

@@ -0,0 +1,79 @@
+import { existsSync, readFileSync, unlinkSync, rmSync } from 'fs';
+import { join } from 'path';
+import { createInterface } from 'readline/promises';
+
+const PKG_NAME = 'opencode-agent-kit';
+
+export async function uninstall(options) {
+  const targetDir = options.dir || process.cwd();
+  const force = options.force;
+
+  console.log(`\n  ${PKG_NAME} uninstall`);
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  Target: ${targetDir}\n`);
+
+  if (!force) {
+    const readline = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await readline.question(
+      `  ⚠  This will remove .opencode/ and opencode.json from\n      ${targetDir}\n\n  ? Continue? [y/N] `,
+    );
+    readline.close();
+    if (answer.toLowerCase() !== 'y') {
+      console.log(`  ✗ Aborted.\n`);
+      process.exit(0);
+    }
+  }
+
+  // Remove .opencode/
+  const opencodeDir = join(targetDir, '.opencode');
+  if (existsSync(opencodeDir)) {
+    console.log(`  Removing .opencode/ ...`);
+    rmSync(opencodeDir, { recursive: true, force: true });
+    console.log(`  ✓ .opencode/ removed`);
+  } else {
+    console.log(`  - .opencode/ not found, skipping`);
+  }
+
+  // Remove opencode.json
+  const configPath = join(targetDir, 'opencode.json');
+  if (existsSync(configPath)) {
+    console.log(`  Removing opencode.json ...`);
+    unlinkSync(configPath);
+    console.log(`  ✓ opencode.json removed`);
+  } else {
+    console.log(`  - opencode.json not found, skipping`);
+  }
+
+  // Remove opencode.example.json
+  const examplePath = join(targetDir, 'opencode.example.json');
+  if (existsSync(examplePath)) {
+    console.log(`  Removing opencode.example.json ...`);
+    unlinkSync(examplePath);
+    console.log(`  ✓ opencode.example.json removed`);
+  }
+
+  // Clean up .gitignore entries (remove lines containing these patterns)
+  const gitignorePath = join(targetDir, '.gitignore');
+  if (existsSync(gitignorePath)) {
+    const entriesToRemove = ['.opencode/', 'opencode.json', 'opencode.example.json'];
+    const content = readFileSync(gitignorePath, 'utf-8');
+    const lines = content.split('\n').filter(line => {
+      return !entriesToRemove.some(e => line.trim().startsWith(e));
+    });
+    const newContent = lines.join('\n');
+    if (newContent !== content) {
+      // Write back without these entries
+      const { writeFileSync } = await import('fs');
+      writeFileSync(gitignorePath, newContent, 'utf-8');
+      console.log(`  ✓ .gitignore cleaned`);
+    }
+  }
+
+  // Clean .kit-version
+  const versionFile = join(opencodeDir, '.kit-version');
+  if (existsSync(versionFile)) {
+    unlinkSync(versionFile);
+  }
+
+  console.log(`\n  ✅ opencode-agent-kit has been removed from ${targetDir}\n`);
+}

package/bin/commands/upgrade.mjs

@@ -0,0 +1,65 @@
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+const PKG_NAME = 'opencode-agent-kit';
+
+/**
+ * Get the currently installed version from package.json
+ */
+function getCurrentVersion() {
+  const pkgPath = new globalThis.URL('../../package.json', import.meta.url);
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+  return pkg.version;
+}
+
+/**
+ * Get the latest available version from npm
+ */
+function getLatestVersion() {
+  try {
+    return execSync(`npm view ${PKG_NAME} version`, {
+      encoding: 'utf-8',
+      timeout: 10000,
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+
+export async function upgrade(options) {
+  const { verbose } = options;
+
+  console.log(`\n  ${PKG_NAME} upgrade`);
+  console.log(`  ${'─'.repeat(50)}\n`);
+
+  const current = getCurrentVersion();
+  console.log(`  Current version: v${current}`);
+
+  console.log(`  Checking npm registry...`);
+  const latest = getLatestVersion();
+
+  if (!latest) {
+    console.error(`  \n  ✗ Could not reach npm registry.`);
+    console.error(`    Check your internet connection and try again.`);
+    process.exit(1);
+  }
+
+  console.log(`  Latest version:  v${latest}`);
+
+  if (current === latest) {
+    console.log(`\n  ✓ You're up to date (v${current}).\n`);
+    return;
+  }
+
+  console.log(`\n  → Upgrading from v${current} to v${latest}...`);
+  try {
+    execSync(`npm install -g ${PKG_NAME}@latest`, {
+      stdio: verbose ? 'inherit' : 'pipe',
+      timeout: 60000,
+    });
+    console.log(`  ✓ Upgraded to v${latest}\n`);
+  } catch (err) {
+    console.error(`  ✗ Upgrade failed: ${err.message}`);
+    console.error(`    Try: npm install -g ${PKG_NAME}@latest`);
+    process.exit(1);
+  }
+}

package/bin/init.mjs

@@ -1,21 +1,44 @@
 #!/usr/bin/env node
 
-import { Command } from "commander";
-import { init } from "./commands/init.mjs";
+import { Command } from 'commander';
+import { init } from './commands/init.mjs';
+import { upgrade } from './commands/upgrade.mjs';
+import { doctor } from './commands/doctor.mjs';
+import { uninstall } from './commands/uninstall.mjs';
 
 const program = new Command();
 
 program
-  .name("opencode-agent-kit")
-  .description("Install OpenCode multi-agent toolkit into your project")
-  .version("1.0.0");
+  .name('opencode-agent-kit')
+  .description('Multi-stack OpenCode agent toolkit — 13 specialized AI agents, 60+ skills, 35+ commands')
+  .version('1.0.0');
 
 program
-  .command("init")
-  .description("Initialize .opencode/ configuration in current project")
-  .option("-f, --force", "Overwrite existing files without prompt")
-  .option("-d, --dir <path>", "Target project directory", process.cwd())
-  .option("--skip-install", "Skip npm/bun install step in .opencode/")
+  .command('init')
+  .description('Initialize .opencode/ configuration in current project')
+  .option('-f, --force', 'Overwrite existing files without prompt')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('--skip-install', 'Skip npm/bun install step in .opencode/')
   .action(init);
 
+program
+  .command('upgrade')
+  .description('Check for and apply the latest version of opencode-agent-kit')
+  .option('-v, --verbose', 'Show detailed upgrade output')
+  .action(upgrade);
+
+program
+  .command('doctor')
+  .description('Diagnose common setup issues in the target project')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('--fix', 'Show actionable fix suggestions')
+  .action(doctor);
+
+program
+  .command('uninstall')
+  .description('Remove opencode-agent-kit configuration from the target project')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('-f, --force', 'Skip confirmation prompt')
+  .action(uninstall);
+
 program.parse();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.19",
-  "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube) with 62 skills, 37 commands, and 7 MCP servers",
+  "version": "1.1.0",
+  "description": "Multi-stack OpenCode agent toolkit \u2014 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube) with 62 skills, 37 commands, and 7 MCP servers",
   "type": "module",
   "bin": {
     "opencode-agent-kit": "./bin/init.mjs"
@@ -25,6 +25,13 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "lint": "eslint bin/ --ext .mjs,.js",
+    "format": "prettier --write 'bin/**/*.mjs' '*.md' '*.json'",
+    "format:check": "prettier --check 'bin/**/*.mjs' '*.md' '*.json'",
+    "generate-template": "bash scripts/generate-template.sh",
+    "prepare": "node -e \"try { require('husky').install() } catch {}\""
+  },
   "keywords": [
     "opencode",
     "ai-agent",
@@ -56,5 +63,11 @@
   "dependencies": {
     "commander": "^13.0.0",
     "fs-extra": "^11.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.4.0"
   }
 }

package/template/opencode.example.json

@@ -10,7 +10,6 @@
       "*.env.*": "deny",
       "*.env.example": "allow"
     },
-    "edit": "allow",
     "webfetch": "allow",
     "skill": {
       "*": "allow"
@@ -24,7 +23,7 @@
     ".opencode/instructions/INSTRUCTIONS.md",
     ".opencode/skills/coding-standards/SKILL.md",
     ".opencode/skills/security-review/SKILL.md",
-    ".opencode/skills/frontend-design/SKILL.md"
+    ".opencode/skills/impeccable/SKILL.md"
   ],
   "mcp": {
     "nuxt": {
@@ -74,8 +73,15 @@
         "Authorization": "Bearer ${SONARQUBE_TOKEN}",
         "SONARQUBE_TOOLSETS": "analysis,issues,security-hotspots,quality-gates,rules,duplications,measures,dependency-risks,coverage,sources,languages,portfolios,system,webhooks"
       }
+    },
+    "agentmemory": {
+      "type": "local",
+      "command": ["bash", ".opencode/hooks/agentmemory-start.sh"],
+      "enabled": true,
+      "description": "Persistent cross-session memory with 53 tools (save, recall, smart search, sessions, file history, lessons)"
     }
   },
+  "plugin": [".opencode/plugins/agentmemory-capture.ts"],
   "agent": {
     "leader": {
       "description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",
@@ -101,6 +107,7 @@
         "figma_*": "ask",
         "playwright_*": "allow",
         "postman_*": "allow",
+        "agentmemory_*": "allow",
         "task": { "*": "allow" }
       }
     },
@@ -126,7 +133,8 @@
         "nuxt_*": "allow",
         "nuxt-ui_*": "allow",
         "figma_*": "ask",
-        "playwright_*": "allow"
+        "playwright_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "frontend-react": {
@@ -149,7 +157,8 @@
           "npx playwright*": "allow"
         },
         "figma_*": "ask",
-        "playwright_*": "allow"
+        "playwright_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "backend": {
@@ -170,7 +179,8 @@
           "bun *": "allow",
           "yarn *": "allow"
         },
-        "postman_*": "allow"
+        "postman_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "ci3": {
@@ -210,7 +220,8 @@
           "git diff": "allow",
           "git log*": "allow"
         },
-        "postman_*": "allow"
+        "postman_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "designer": {
@@ -232,7 +243,8 @@
         },
         "stitch_*": "allow",
         "figma_*": "ask",
-        "nuxt-ui_*": "allow"
+        "nuxt-ui_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "reviewer": {
@@ -254,7 +266,8 @@
           "yarn *": "allow",
           "npx playwright*": "allow"
         },
-        "playwright_*": "allow"
+        "playwright_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "database": {
@@ -274,28 +287,8 @@
           "pnpm *": "allow",
           "bun *": "allow",
           "yarn *": "allow"
-        }
-      }
-    },
-    "devops": {
-      "description": "DevOps Engineer specializing in CI/CD, deployment, Docker, monitoring, and infrastructure (subagent of IT Leader)",
-      "mode": "subagent",
-      "prompt": "{file:.opencode/agents/devops-specialist.md}",
-      "model": "opencode/claude-sonnet-4.5",
-      "temperature": 0.4,
-      "color": "#6366f1",
-      "permission": {
-        "edit": "allow",
-        "webfetch": "allow",
-        "skill": { "*": "allow" },
-        "bash": {
-          "*": "ask",
-          "npm *": "allow",
-          "pnpm *": "allow",
-          "bun *": "allow",
-          "yarn *": "allow",
-          "docker *": "allow"
-        }
+        },
+        "agentmemory_*": "allow"
       }
     },
     "seo": {
@@ -315,7 +308,8 @@
           "git diff": "allow",
           "git log*": "allow"
         },
-        "nuxt_*": "allow"
+        "nuxt_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "android": {
@@ -335,7 +329,8 @@
           "gradle *": "allow"
         },
         "figma_*": "ask",
-        "playwright_*": "allow"
+        "playwright_*": "allow",
+        "agentmemory_*": "allow"
       }
     },
     "flutter": {
@@ -355,7 +350,8 @@
           "dart *": "allow"
         },
         "figma_*": "ask",
-        "playwright_*": "allow"
+        "playwright_*": "allow",
+        "agentmemory_*": "allow"
       }
     }
   }

package/template/opencode.json

@@ -22,7 +22,7 @@
     ".opencode/instructions/INSTRUCTIONS.md",
     ".opencode/skills/coding-standards/SKILL.md",
     ".opencode/skills/security-review/SKILL.md",
-    ".opencode/skills/frontend-design/SKILL.md"
+    ".opencode/skills/impeccable/SKILL.md"
   ],
   "mcp": {
     "nuxt": {
@@ -93,7 +93,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -119,7 +119,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -143,7 +143,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -165,7 +165,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -185,7 +185,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "git status": "allow",
           "git diff": "allow",
           "git log*": "allow"
@@ -204,7 +204,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "git status": "allow",
           "git diff": "allow",
           "git log*": "allow"
@@ -223,7 +223,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "git status": "allow",
           "git diff": "allow",
           "git log*": "allow"
@@ -244,7 +244,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -265,7 +265,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -284,7 +284,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "npm *": "allow",
           "pnpm *": "allow",
           "bun *": "allow",
@@ -304,7 +304,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "git status": "allow",
           "git diff": "allow",
           "git log*": "allow"
@@ -323,7 +323,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "./gradlew *": "allow",
           "gradle *": "allow"
         },
@@ -342,7 +342,7 @@
         "webfetch": "allow",
         "skill": { "*": "allow" },
         "bash": {
-          "*": "allow",
+          "*": "ask",
           "flutter *": "allow",
           "dart *": "allow"
         },