vibe-cokit 1.12.0 → 1.14.0

package/README.md

@@ -1,6 +1,6 @@
 # vibe-cokit (vk)
 
-A toolkit for interacting with Claude Code and OpenCode.
+A toolkit for interacting with Claude Code, Antigravity, and OpenCode.
 
 ## Install
 
@@ -8,14 +8,23 @@ A toolkit for interacting with Claude Code and OpenCode.
 bun install -g vibe-cokit
 ```
 
+## Supported Setup Flows
+
+- `claude-code` - installs the standard Claude Code project kit
+- `antigravity` - installs the Antigravity project kit
+- `opencode` - installs `AGENTS.md`, `opencode.jsonc`, `.opencode/`, and `docs/opencode/`
+
 ## Commands
 
 ```bash
 vk init                # Initialize vibe-cokit for current project
+vk init antigravity    # Install the Antigravity kit in current project
 vk init opencode       # Install the OpenCode kit in current project
 vk update              # Update CLI + config + skills
+vk update antigravity  # Update the Antigravity kit in current project
 vk update opencode     # Update the OpenCode kit in current project
 vk skills              # Install/update skills
+vk version             # Show CLI + installed kit versions
 vk doctor              # Health check setup
 vk doctor --fix        # Auto-fix setup issues
 vk help                # Show detailed usage guide
@@ -49,6 +58,12 @@ Available plugins: `context7`, `code-review`, `ralph-loop`, `typescript-lsp`, `p
 - [git](https://git-scm.com) — Git version control
 - [claude](https://docs.anthropic.com/en/docs/claude-code) — Claude Code CLI (for Claude setup and mcp/plugin commands)
 
+## Files Created
+
+- `./CLAUDE.md` - project-level Claude config created by `vk init`
+- `./opencode.jsonc` - project-level OpenCode config created by `vk init opencode`
+- `./.opencode/` - local OpenCode agents and metadata created by `vk init opencode`
+
 ## Development
 
 ```bash

package/dist/cli.js

@@ -728,7 +728,7 @@ var dist_default = cac;
 var version = "0.1.0";
 
 // src/commands/init.ts
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 
 // src/utils/config.ts
 import { homedir as homedir2 } from "os";
@@ -1266,8 +1266,8 @@ function getNative(object, key) {
 var _getNative_default = getNative;
 
 // node_modules/lodash-es/_Map.js
-var Map = _getNative_default(_root_default, "Map");
-var _Map_default = Map;
+var Map2 = _getNative_default(_root_default, "Map");
+var _Map_default = Map2;
 
 // node_modules/lodash-es/_nativeCreate.js
 var nativeCreate = _getNative_default(Object, "create");
@@ -2475,7 +2475,6 @@ async function requireClaude() {
 var exec2 = promisify2(execFile2);
 var REPO = "vibe-cokit/claude-code";
 var ANTIGRAVITY_REPO = "vibe-cokit/antigravity";
-var OPENCODE_REPO = "vibe-cokit/opencode";
 var SKILLS_REPO = "vibe-cokit/skills";
 var CLAUDE_DIR = join2(homedir2(), ".claude");
 var CLAUDE_SKILLS_DIR = join2(CLAUDE_DIR, "skills");
@@ -2691,6 +2690,316 @@ async function ensureGitignore(entry) {
   }
 }
 
+// src/utils/opencode-kit.ts
+import { basename, join as join3, relative } from "path";
+import { mkdir as mkdir3, readdir as readdir3, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+
+// src/utils/opencode-constants.ts
+var OPENCODE_WORKFLOW_FILES = [
+  "development-rules.md",
+  "documentation-management.md",
+  "orchestration-protocol.md",
+  "primary-workflow.md"
+];
+var OPENCODE_AGENT_DESCRIPTIONS = {
+  brainstormer: "Debates solution options, tradeoffs, and product direction before implementation.",
+  "code-reviewer": "Reviews code for bugs, regressions, security risks, and missing work.",
+  copywriter: "Writes and improves product, UI, and marketing copy.",
+  "database-admin": "Handles schema design, query quality, and database operations.",
+  debugger: "Investigates root causes, reproduces issues, and guides fixes.",
+  "docs-manager": "Creates and updates project documentation under docs/.",
+  "git-manager": "Stages, commits, pushes, and helps with pull request workflows.",
+  "journal-writer": "Writes development journal entries and status notes.",
+  "mcp-manager": "Discovers and executes MCP tools while keeping the main context clean.",
+  planner: "Researches the codebase and produces phased implementation plans.",
+  "project-manager": "Maintains roadmap, task status, and delivery progress.",
+  "refactor-cleaner": "Finds dead code and performs careful cleanup refactors.",
+  researcher: "Performs web and docs research and returns concise technical findings.",
+  "scout-external": "Scouts external tools, docs, and reference implementations.",
+  scout: "Searches the codebase quickly and returns the most relevant files.",
+  "security-reviewer": "Performs focused security review and hardening guidance.",
+  tester: "Runs builds and tests, diagnoses failures, and verifies fixes.",
+  "text-to-sql": "Manages the semantic SQL layer and generates validated SQL from natural language.",
+  "ui-ux-designer": "Designs and implements UI with strong visual and UX standards."
+};
+var OPENCODE_COMMAND_AGENT_MAP = new Map([
+  ["vk:ask", "brainstormer"],
+  ["vk:brainstorm", "brainstormer"],
+  ["vk:content:cro", "copywriter"],
+  ["vk:content:enhance", "copywriter"],
+  ["vk:content:fast", "copywriter"],
+  ["vk:content:good", "copywriter"],
+  ["vk:debug", "debugger"],
+  ["vk:design:3d", "ui-ux-designer"],
+  ["vk:design:describe", "ui-ux-designer"],
+  ["vk:design:fast", "ui-ux-designer"],
+  ["vk:design:good", "ui-ux-designer"],
+  ["vk:design:screenshot", "ui-ux-designer"],
+  ["vk:design:video", "ui-ux-designer"],
+  ["vk:docs:init", "docs-manager"],
+  ["vk:docs:summarize", "docs-manager"],
+  ["vk:docs:update", "docs-manager"],
+  ["vk:git:cm", "git-manager"],
+  ["vk:git:cp", "git-manager"],
+  ["vk:git:pr", "git-manager"],
+  ["vk:journal", "journal-writer"],
+  ["vk:plan", "planner"],
+  ["vk:plan:ci", "planner"],
+  ["vk:plan:cro", "planner"],
+  ["vk:plan:fast", "planner"],
+  ["vk:plan:hard", "planner"],
+  ["vk:plan:two", "planner"],
+  ["vk:refactor-clean", "refactor-cleaner"],
+  ["vk:review:codebase", "code-reviewer"],
+  ["vk:scout", "scout"],
+  ["vk:scout:ext", "scout-external"],
+  ["vk:sql", "text-to-sql"],
+  ["vk:sql:manage", "text-to-sql"],
+  ["vk:sql:optimize", "text-to-sql"],
+  ["vk:sql:setup", "text-to-sql"],
+  ["vk:test", "tester"],
+  ["vk:use-mcp", "mcp-manager"]
+]);
+var OPENCODE_COMMAND_ROOTS = [
+  "ask",
+  "brainstorm",
+  "bootstrap",
+  "code",
+  "content",
+  "cook",
+  "debug",
+  "design",
+  "docs",
+  "fix",
+  "git",
+  "integrate",
+  "journal",
+  "plan",
+  "refactor-clean",
+  "review",
+  "scout",
+  "skill",
+  "sql",
+  "test",
+  "use-mcp",
+  "watzup"
+];
+
+// src/utils/opencode-kit.ts
+var SQL_CLI_BLOCK = `## CLI
+
+Resolve \`TEXT_TO_SQL_SCRIPT\` to the first existing path among:
+
+- \`.opencode/skills/text-to-sql/scripts/text-to-sql.js\`
+- \`$HOME/.config/opencode/skills/text-to-sql/scripts/text-to-sql.js\`
+- \`$HOME/.claude/skills/text-to-sql/scripts/text-to-sql.js\`
+- \`$HOME/.agents/skills/text-to-sql/scripts/text-to-sql.js\`
+
+`;
+async function buildOpenCodeKit(sourceDir, outputDir = sourceDir) {
+  const commandsDir = join3(sourceDir, "commands", "vk");
+  const agentsDir = join3(sourceDir, "agents");
+  const targetAgentsDir = join3(outputDir, ".opencode", "agents");
+  const targetDocsDir = join3(outputDir, "docs", "opencode");
+  await mkdir3(targetAgentsDir, { recursive: true });
+  await mkdir3(targetDocsDir, { recursive: true });
+  const commandFiles = await listMarkdownFiles(commandsDir);
+  const agentFiles = await listMarkdownFiles(agentsDir);
+  const commands = {};
+  for (const file of agentFiles) {
+    const raw = await readFile2(file, "utf8");
+    const { body } = splitFrontmatter(raw);
+    const name = basename(file, ".md");
+    const content = `${buildAgentFrontmatter(name)}${rewriteCommon(body).trimStart()}`;
+    await writeFile2(join3(targetAgentsDir, `${name}.md`), withTrailingNewline(content));
+  }
+  for (const file of commandFiles) {
+    const raw = await readFile2(file, "utf8");
+    const { frontmatter, body } = splitFrontmatter(raw);
+    const relativePath = relative(commandsDir, file).replaceAll("\\", "/");
+    const name = `vk:${relativePath.replace(/\.md$/, "").replaceAll("/", ":")}`;
+    const command = {
+      description: sanitizeDescription(getFrontmatterValue(frontmatter, "description") || name),
+      template: finalizeCommandTemplate(name, rewriteCommon(body).trim())
+    };
+    const agent = OPENCODE_COMMAND_AGENT_MAP.get(name);
+    if (agent) {
+      command.agent = agent;
+      command.subtask = true;
+    }
+    commands[name] = command;
+  }
+  for (const workflowFile of OPENCODE_WORKFLOW_FILES) {
+    const raw = await readFile2(join3(sourceDir, "workflows", workflowFile), "utf8");
+    await writeFile2(join3(targetDocsDir, workflowFile), withTrailingNewline(rewriteCommon(raw)));
+  }
+  await Promise.all([
+    writeFile2(join3(outputDir, "AGENTS.md"), withTrailingNewline(buildAgentsMd())),
+    writeFile2(join3(outputDir, "README.md"), withTrailingNewline(buildReadme(commandFiles.length, agentFiles.length))),
+    writeFile2(join3(outputDir, ".gitignore"), buildGitignore()),
+    writeFile2(join3(outputDir, ".markdownlint.json"), await readFile2(join3(sourceDir, ".markdownlint.json"), "utf8")),
+    writeFile2(join3(outputDir, "LICENSE"), await readFile2(join3(sourceDir, "LICENSE"), "utf8")),
+    writeFile2(join3(targetDocsDir, "README.md"), withTrailingNewline(buildDocsIndex())),
+    writeFile2(join3(targetDocsDir, "research.md"), withTrailingNewline(buildResearchDoc())),
+    writeFile2(join3(targetDocsDir, "agent-map.md"), withTrailingNewline(buildMapDoc("Agent Map", agentFiles, sourceDir))),
+    writeFile2(join3(targetDocsDir, "command-map.md"), withTrailingNewline(buildMapDoc("Command Map", commandFiles, sourceDir))),
+    writeFile2(join3(outputDir, "opencode.jsonc"), `${JSON.stringify(buildConfig(commands), null, 2)}
+`)
+  ]);
+}
+async function listMarkdownFiles(dir) {
+  const entries = await readdir3(dir, { withFileTypes: true });
+  const files = await Promise.all(entries.map(async (entry) => {
+    const fullPath = join3(dir, entry.name);
+    if (entry.isDirectory())
+      return listMarkdownFiles(fullPath);
+    return entry.name.endsWith(".md") ? [fullPath] : [];
+  }));
+  return files.flat().sort();
+}
+function splitFrontmatter(raw) {
+  if (!raw.startsWith(`---
+`))
+    return { frontmatter: "", body: raw };
+  const end = raw.indexOf(`
+---
+`, 4);
+  return end === -1 ? { frontmatter: "", body: raw } : { frontmatter: raw.slice(4, end), body: raw.slice(end + 5) };
+}
+function getFrontmatterValue(frontmatter, key) {
+  return frontmatter.match(new RegExp(`^${escapeForRegExp(key)}:\\s*(.*)$`, "m"))?.[1]?.trim() ?? "";
+}
+function rewriteCommon(text) {
+  let next = text.replaceAll(`\r
+`, `
+`);
+  next = next.replaceAll("./.claude/workflows/", "./docs/opencode/").replaceAll("./docs/development-rules.md", "./docs/opencode/development-rules.md").replaceAll("./.claude/commands/vk/scout.md", "./opencode.jsonc").replaceAll("CLAUDE.md", "AGENTS.md").replaceAll("Slash Commands", "commands").replaceAll("Slash commands", "commands").replaceAll("SlashCommand", "command").replaceAll("slash commands", "commands").replaceAll("slash command", "command").replaceAll("`/.claude/skills/*`", "`.opencode/skills/*`, `~/.claude/skills/*`, or `.agents/skills/*`").replaceAll(".claude/skills/*", ".opencode/skills/*, ~/.claude/skills/*, or .agents/skills/*");
+  for (const root2 of OPENCODE_COMMAND_ROOTS) {
+    const pattern = new RegExp(`/${escapeForRegExp(root2)}(?=[:\\s"'<>())])`, "g");
+    next = next.replace(pattern, `/vk:${root2}`);
+  }
+  return next.replace(/(?<!\/vk:)\/scout\b/g, "/vk:scout");
+}
+function finalizeCommandTemplate(name, template) {
+  let next = template;
+  if (name.startsWith("vk:skill:"))
+    next = next.replaceAll(".claude/skills/", ".opencode/skills/");
+  if (name === "vk:sql" || name === "vk:sql:manage") {
+    const heading = name === "vk:sql" ? "## Workflow" : "## Commands";
+    next = next.replace(/## CLI[\s\S]*?## (Workflow|Commands)/, `${SQL_CLI_BLOCK}${heading}`).replaceAll("$SCRIPT", "$TEXT_TO_SQL_SCRIPT");
+  }
+  if (name === "vk:sql:optimize" || name === "vk:sql:setup") {
+    next = next.replace(/^# [^\n]+\n\n/, (match) => `${match}${SQL_CLI_BLOCK}`).replaceAll("node $HOME/.claude/skills/text-to-sql/scripts/text-to-sql.js", "node $TEXT_TO_SQL_SCRIPT");
+  }
+  if (name === "vk:sql:optimize")
+    next = next.replace("/vk:sql init", "/vk:sql:manage init").replace("/vk:sql setup", "/vk:sql:setup");
+  if (name === "vk:sql:setup") {
+    next = next.replaceAll("$HOME/.claude/skills/text-to-sql/.env", "the `.env` file that lives next to the resolved `TEXT_TO_SQL_SCRIPT`").replace("Read `DIRECT_URL` from the `the `.env` file that lives next to the resolved `TEXT_TO_SQL_SCRIPT``", "Read `DIRECT_URL` from the `.env` file that lives next to the resolved `TEXT_TO_SQL_SCRIPT`");
+  }
+  return next;
+}
+function buildConfig(commands) {
+  return {
+    $schema: "https://opencode.ai/config.json",
+    default_agent: "build",
+    share: "manual",
+    autoupdate: "notify",
+    instructions: ["AGENTS.md", "docs/opencode/development-rules.md", "docs/opencode/orchestration-protocol.md", "docs/opencode/primary-workflow.md", "docs/opencode/documentation-management.md"],
+    watcher: { ignore: [".git/**", "node_modules/**", "dist/**", "build/**", "coverage/**", ".next/**"] },
+    permission: { bash: { "*": "allow", "git push*": "ask", "git reset --hard*": "ask", "rm -rf *": "ask" } },
+    agent: { plan: { permission: { edit: "deny", bash: "deny" } } },
+    command: commands
+  };
+}
+function buildAgentFrontmatter(name) {
+  return `---
+description: ${JSON.stringify(OPENCODE_AGENT_DESCRIPTIONS[name] ?? `Specialized ${name} subagent.`)}
+mode: subagent
+---
+
+`;
+}
+function buildAgentsMd() {
+  return `# AGENTS.md
+
+This repository is the OpenCode port of the vibe-cokit Claude Code kit.
+
+- \`.opencode/agents/\` contains the custom OpenCode subagents.
+- \`opencode.jsonc\` contains the command registry and project OpenCode settings.
+- \`docs/opencode/\` replaces the old \`.claude/workflows/\` references.
+
+Follow YAGNI, KISS, and DRY. Prefer the \`/vk:*\` commands for the ported vibe-cokit workflows. Check skills in \`.opencode/skills/*/SKILL.md\`, then \`~/.config/opencode/skills/*/SKILL.md\`, then Claude-compatible fallback locations.
+`;
+}
+function buildReadme(commandCount, agentCount) {
+  return `# vibe-cokit OpenCode kit
+
+OpenCode-native port of the vibe-cokit Claude Code workflow set.
+
+- \`AGENTS.md\` for project rules
+- \`opencode.jsonc\` for OpenCode config and the full \`/vk:*\` command registry
+- \`.opencode/agents/\` with ${agentCount} custom subagents
+- \`docs/opencode/\` with workflow docs, source maps, and porting notes
+
+This kit currently ports ${commandCount} \`/vk:*\` commands from the Claude Code source kit.
+`;
+}
+function buildDocsIndex() {
+  return `# OpenCode Port Docs
+
+- [research.md](research.md)
+- [command-map.md](command-map.md)
+- [agent-map.md](agent-map.md)
+- [development-rules.md](development-rules.md)
+- [orchestration-protocol.md](orchestration-protocol.md)
+- [primary-workflow.md](primary-workflow.md)
+- [documentation-management.md](documentation-management.md)
+`;
+}
+function buildResearchDoc() {
+  return `# Research Notes
+
+This port follows the official OpenCode docs for agents, commands, config, and rules.
+
+Sources:
+- https://opencode.ai/docs/
+- https://opencode.ai/docs/agents/
+- https://opencode.ai/docs/commands/
+- https://opencode.ai/docs/config/
+- https://opencode.ai/docs/rules/
+`;
+}
+function buildMapDoc(title, files, sourceDir) {
+  const rows = files.map((file) => {
+    const relativePath = relative(sourceDir, file).replaceAll("\\", "/");
+    const name = relativePath.startsWith("commands/vk/") ? `vk:${relativePath.slice("commands/vk/".length).replace(/\.md$/, "").replaceAll("/", ":")}` : basename(file, ".md");
+    return `| \`${name}\` | \`${relativePath}\` |`;
+  }).join(`
+`);
+  return `# ${title}
+
+| OpenCode name | Claude source |
+| --- | --- |
+${rows}
+`;
+}
+function buildGitignore() {
+  return ["cache", "debug", "file-history", "ide", "paste-cache", "plans", "plugins", ".gitmodules", "projects", "session-env", "shell-snapshots", "skills", "statsig", "tasks", "teams", "telemetry", "todos", "history.jsonl", "settings.json", "stats-cache.json", ".opencode/.vk.json"].join(`
+`) + `
+`;
+}
+function sanitizeDescription(text) {
+  return text.replace(/[^\x20-\x7E]/g, " ").replace(/\s+/g, " ").trim();
+}
+function withTrailingNewline(text) {
+  return text.endsWith(`
+`) ? text : `${text}
+`;
+}
+function escapeForRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 // src/commands/init.ts
 var VALID_AGENTS = ["claude-code", "antigravity", "opencode"];
 async function initCommand(agent) {
@@ -2712,7 +3021,7 @@ async function initCommand(agent) {
   }
 }
 async function initClaudeCode() {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit init (claude-code)
@@ -2747,7 +3056,7 @@ vibe-cokit init (claude-code)
   }
 }
 async function initAntigravity() {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit init (antigravity)
@@ -2758,12 +3067,12 @@ vibe-cokit init (antigravity)
     await cloneRepo(tmpDir, ANTIGRAVITY_REPO);
     log("Copying agent config to .agents/...");
     await copyAgentFolder(tmpDir);
-    const skillsTmpDir = join3(TEMP_DIR, crypto.randomUUID());
+    const skillsTmpDir = join4(TEMP_DIR, crypto.randomUUID());
     try {
       log("Cloning skills repository...");
       await cloneRepo(skillsTmpDir, SKILLS_REPO);
       log("Installing skills to .agent/skills/...");
-      await copySkillFolders(skillsTmpDir, join3(process.cwd(), ".agent", "skills"));
+      await copySkillFolders(skillsTmpDir, join4(process.cwd(), ".agent", "skills"));
     } finally {
       await cleanup(skillsTmpDir);
     }
@@ -2789,15 +3098,17 @@ vibe-cokit init (antigravity)
   }
 }
 async function initOpenCode() {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit init (opencode)
 `);
     log("Verifying prerequisites...");
     await verifyPrerequisites();
-    log("Cloning OpenCode kit...");
-    await cloneRepo(tmpDir, OPENCODE_REPO);
+    log("Cloning Claude Code source...");
+    await cloneRepo(tmpDir, REPO);
+    log("Generating OpenCode kit...");
+    await buildOpenCodeKit(tmpDir);
     log("Installing OpenCode kit into current project...");
     await copyOpenCodeKit(tmpDir);
     log("Updating version tracking...");
@@ -2822,7 +3133,7 @@ vibe-cokit init (opencode)
 }
 
 // src/commands/update.ts
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import { execFile as execFile3 } from "child_process";
 import { promisify as promisify3 } from "util";
 var exec3 = promisify3(execFile3);
@@ -2886,7 +3197,7 @@ async function updateClaudeCode(ref) {
   await updateSkills(ref);
 }
 async function updateConfig(ref) {
-  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking config version...");
     const currentSha = await getCurrentVersion();
@@ -2913,7 +3224,7 @@ async function updateConfig(ref) {
   }
 }
 async function updateSkills(ref, destDir) {
-  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking skills version...");
     const currentSha = await getSkillsVersion();
@@ -2942,7 +3253,7 @@ async function updateSkills(ref, destDir) {
   }
 }
 async function updateAntigravity(ref) {
-  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking antigravity version...");
     const currentSha = await getAntigravityVersion();
@@ -2969,22 +3280,24 @@ async function updateAntigravity(ref) {
   }
 }
 async function updateOpenCode(ref) {
-  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking OpenCode kit version...");
     const currentSha = await getOpenCodeVersion();
     log("Fetching latest OpenCode kit version...");
-    const targetSha = await getRemoteSha(ref, OPENCODE_REPO);
+    const targetSha = await getRemoteSha(ref, REPO);
     if (currentSha && currentSha === targetSha) {
       log(`OpenCode kit: up-to-date (${currentSha.slice(0, 8)})`);
       return;
     }
-    log("Cloning OpenCode kit...");
-    await cloneRepo(tmpDir, OPENCODE_REPO);
+    log("Cloning Claude Code source...");
+    await cloneRepo(tmpDir, REPO);
     if (ref) {
       log(`Checking out ${ref}...`);
       await exec3("git", ["-C", tmpDir, "checkout", ref]);
     }
+    log("Generating OpenCode kit...");
+    await buildOpenCodeKit(tmpDir);
     log("Updating OpenCode kit in current project...");
     await copyOpenCodeKit(tmpDir);
     const sha = await getCommitSha(tmpDir);
@@ -2997,12 +3310,12 @@ async function updateOpenCode(ref) {
 }
 
 // src/commands/skills.ts
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { execFile as execFile4 } from "child_process";
 import { promisify as promisify4 } from "util";
 var exec4 = promisify4(execFile4);
 async function skillsCommand(ref) {
-  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join6(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit skills
@@ -3075,6 +3388,8 @@ COMMANDS
   plugin install    Install Claude Code plugins (code-review, typescript-lsp, etc.)
   plugin uninstall  Remove Claude Code plugins
 
+  docker container stop all  Stop all Docker containers
+
   help              Show this detailed usage guide
 
   version           Show version and installed commit IDs
@@ -3096,6 +3411,7 @@ EXAMPLES
   vk plugin install context7 code-review   # Install specific plugins
   vk plugin install --all                  # Install all plugins
   vk plugin uninstall hookify              # Remove a plugin
+  vk docker container stop all             # Stop all docker containers
   vk doctor                                # Health check setup
   vk doctor --fix                          # Auto-fix setup issues
 
@@ -3143,12 +3459,12 @@ vibe-cokit v${version}`);
 }
 
 // src/commands/doctor.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // src/utils/keyboard.ts
 import { homedir as homedir3, platform } from "os";
-import { join as join6, dirname as dirname2, basename } from "path";
-import { readdir as readdir3, stat as stat3, cp as cp2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { join as join7, dirname as dirname2, basename as basename2 } from "path";
+import { readdir as readdir4, stat as stat3, cp as cp2, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
 var PATCH_MARKER = "/* Vietnamese IME fix */";
 var DEL_CHAR = "\x7F";
 function detectFileType(filePath) {
@@ -3160,15 +3476,15 @@ function detectFileType(filePath) {
 async function findCliJs() {
   const home = homedir3();
   const isWin = platform() === "win32";
-  const nativePath = join6(home, ".local", "share", "claude", "versions");
+  const nativePath = join7(home, ".local", "share", "claude", "versions");
   try {
     const s = await stat3(nativePath);
     if (s.isDirectory()) {
-      const entries = await readdir3(nativePath);
+      const entries = await readdir4(nativePath);
       const versions = entries.filter((e) => /^\d+\.\d+\.\d+$/.test(e));
       versions.sort((a, b) => b.localeCompare(a, undefined, { numeric: true }));
       for (const ver of versions) {
-        const binPath = join6(nativePath, ver);
+        const binPath = join7(nativePath, ver);
         try {
           const bs = await stat3(binPath);
           if (bs.isFile())
@@ -3178,11 +3494,11 @@ async function findCliJs() {
     }
   } catch {}
   const searchDirs = isWin ? [
-    join6(process.env.LOCALAPPDATA ?? "", "npm-cache", "_npx"),
-    join6(process.env.APPDATA ?? "", "npm", "node_modules")
+    join7(process.env.LOCALAPPDATA ?? "", "npm-cache", "_npx"),
+    join7(process.env.APPDATA ?? "", "npm", "node_modules")
   ] : [
-    join6(home, ".npm", "_npx"),
-    join6(home, ".nvm", "versions", "node"),
+    join7(home, ".npm", "_npx"),
+    join7(home, ".nvm", "versions", "node"),
     "/usr/local/lib/node_modules",
     "/opt/homebrew/lib/node_modules"
   ];
@@ -3205,13 +3521,13 @@ async function findCliJsRecursive(dir, depth, maxDepth) {
   if (depth >= maxDepth)
     return null;
   try {
-    const entries = await readdir3(dir, { withFileTypes: true });
+    const entries = await readdir4(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const fullPath = join6(dir, entry.name);
+      const fullPath = join7(dir, entry.name);
       if (entry.name === "@anthropic-ai") {
-        const cliJs = join6(fullPath, "claude-code", "cli.js");
+        const cliJs = join7(fullPath, "claude-code", "cli.js");
         try {
           const s = await stat3(cliJs);
           if (s.isFile())
@@ -3230,7 +3546,7 @@ async function findCliJsRecursive(dir, depth, maxDepth) {
 }
 async function readContent(filePath, fileType) {
   if (fileType === "binary") {
-    const buf = await readFile2(filePath);
+    const buf = await readFile3(filePath);
     return buf.toString("latin1");
   }
   return Bun.file(filePath).text();
@@ -3238,7 +3554,7 @@ async function readContent(filePath, fileType) {
 async function writeContent(filePath, content, fileType) {
   if (fileType === "binary") {
     const bytes = Buffer.from(content, "latin1");
-    await writeFile2(filePath, bytes);
+    await writeFile3(filePath, bytes);
   } else {
     await Bun.write(filePath, content);
   }
@@ -3343,7 +3659,7 @@ async function patchCliJs(filePath) {
   }
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
   const backupDir = fileType === "binary" ? "/tmp" : dirname2(filePath);
-  const backupPath = join6(backupDir, `${basename(filePath)}.backup-${timestamp}`);
+  const backupPath = join7(backupDir, `${basename2(filePath)}.backup-${timestamp}`);
   await cp2(filePath, backupPath);
   try {
     const bugPattern = getBugPattern(fileType);
@@ -3487,7 +3803,7 @@ vibe-cokit doctor
     issues++;
   }
   for (const folder of CONFIG_FOLDERS) {
-    const path = join7(CLAUDE_DIR, folder);
+    const path = join8(CLAUDE_DIR, folder);
     if (await dirExists(path)) {
       console.log(`  \u2713 ~/.claude/${folder}/`);
     } else {
@@ -3501,7 +3817,7 @@ vibe-cokit doctor
     console.log(`  \u2717 ~/.claude/skills/ missing \u2014 run \`vk skills\``);
     issues++;
   }
-  const settingsPath = join7(CLAUDE_DIR, "settings.json");
+  const settingsPath = join8(CLAUDE_DIR, "settings.json");
   if (await fileExists(settingsPath)) {
     console.log(`  \u2713 ~/.claude/settings.json`);
   } else {
@@ -3526,7 +3842,7 @@ vibe-cokit doctor
   } else {
     console.log(`  \u26A0 Claude Code CLI: not found`);
   }
-  const claudeMdExists = await fileExists(join7(process.cwd(), "CLAUDE.md"));
+  const claudeMdExists = await fileExists(join8(process.cwd(), "CLAUDE.md"));
   console.log(`  Project CLAUDE.md: ${claudeMdExists ? "found" : "not found"}`);
   console.log();
   if (issues === 0) {
@@ -3539,7 +3855,7 @@ vibe-cokit doctor
 }
 
 // src/commands/doctor-fix.ts
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 async function doctorFixCommand() {
   console.log(`
 vibe-cokit doctor fix
@@ -3555,12 +3871,12 @@ vibe-cokit doctor fix
     process.exit(1);
   }
   let fixed = 0;
-  const folderChecks = await Promise.all(CONFIG_FOLDERS.map((f) => dirExists(join8(CLAUDE_DIR, f))));
+  const folderChecks = await Promise.all(CONFIG_FOLDERS.map((f) => dirExists(join9(CLAUDE_DIR, f))));
   const configMissing = !await dirExists(CLAUDE_DIR) || some_default(folderChecks, (exists) => !exists) || !await getCurrentVersion();
-  const claudeMdPath = join8(process.cwd(), "CLAUDE.md");
+  const claudeMdPath = join9(process.cwd(), "CLAUDE.md");
   const claudeMdMissing = !await fileExists(claudeMdPath);
   if (configMissing || claudeMdMissing) {
-    const tmpDir = join8(TEMP_DIR, crypto.randomUUID());
+    const tmpDir = join9(TEMP_DIR, crypto.randomUUID());
     try {
       await cloneRepo(tmpDir);
       if (configMissing) {
@@ -3594,7 +3910,7 @@ vibe-cokit doctor fix
   const skillsMissing = !await dirExists(CLAUDE_SKILLS_DIR) || !await getSkillsVersion();
   if (skillsMissing) {
     log("Skills missing \u2014 installing...");
-    const tmpDir = join8(TEMP_DIR, crypto.randomUUID());
+    const tmpDir = join9(TEMP_DIR, crypto.randomUUID());
     try {
       await cloneRepo(tmpDir, SKILLS_REPO);
       await copySkillFolders(tmpDir);
@@ -4067,8 +4383,8 @@ vibe-cokit tools
 }
 
 // src/commands/logs.ts
-import { readdir as readdir4, unlink as unlink2 } from "fs/promises";
-import { join as join9 } from "path";
+import { readdir as readdir5, unlink as unlink2 } from "fs/promises";
+import { join as join10 } from "path";
 var LOG_FILE_PATTERN2 = /^vk-\d{4}-\d{2}-\d{2}\.log$/;
 async function showLogs(lines) {
   const logDir = logger.getLogDir();
@@ -4078,9 +4394,9 @@ async function showLogs(lines) {
   }
   if (!targetPath) {
     try {
-      const files = (await readdir4(logDir)).filter((f) => LOG_FILE_PATTERN2.test(f)).sort().reverse();
+      const files = (await readdir5(logDir)).filter((f) => LOG_FILE_PATTERN2.test(f)).sort().reverse();
       if (files.length > 0) {
-        targetPath = join9(logDir, files[0]);
+        targetPath = join10(logDir, files[0]);
       }
     } catch {}
   }
@@ -4105,10 +4421,10 @@ async function clearLogs() {
   const logDir = logger.getLogDir();
   let count = 0;
   try {
-    const files = await readdir4(logDir);
+    const files = await readdir5(logDir);
     for (const file of files) {
       if (LOG_FILE_PATTERN2.test(file)) {
-        await unlink2(join9(logDir, file));
+        await unlink2(join10(logDir, file));
         count++;
       }
     }
@@ -4135,6 +4451,36 @@ async function logsCommand(options) {
   return showLogs(lines);
 }
 
+// src/commands/docker.ts
+import { exec as exec7 } from "child_process";
+import { promisify as promisify7 } from "util";
+var execAsync = promisify7(exec7);
+async function dockerStopAllCommand() {
+  try {
+    console.log(`
+Stopping all Docker containers...`);
+    const { stdout: containerIds } = await execAsync("docker ps -a -q");
+    if (!containerIds.trim()) {
+      console.log(`\u2713 No Docker containers found to stop
+`);
+      return;
+    }
+    const ids = containerIds.trim().replace(/\n/g, " ");
+    const { stdout } = await execAsync(`docker stop ${ids}`);
+    console.log(`\u2713 Successfully stopped containers:
+${stdout.trim()}
+`);
+  } catch (err) {
+    const msg = getErrorMsg(err);
+    logError("docker container stop all", err);
+    console.error(`
+\u2717 Failed to stop containers:
+${msg}
+`);
+    process.exit(1);
+  }
+}
+
 // src/cli.ts
 var debugMode = process.argv.includes("--debug") || process.env["VK_DEBUG"] === "1";
 await logger.init(debugMode);
@@ -4161,6 +4507,9 @@ cli.command("plugin [action] [...plugins]", "Manage plugins (install/uninstall)"
 cli.command("tools [action] [...args]", "Developer utilities (kill-port, etc.)").action((action, args) => {
   return toolsCommand(action, args);
 });
+cli.command("docker container stop all", "Stop all docker containers").action(() => {
+  return dockerStopAllCommand();
+});
 cli.command("logs", "View or manage diagnostic log files (~/.vk/logs/)").option("--tail <n>", "Number of lines to show (default: 50)").option("--clear", "Delete all log files").option("--path", "Print log directory path").action((options) => logsCommand(options));
 cli.option("--debug", "Enable debug logging to ~/.vk/logs/");
 cli.help();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-cokit",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "A toolkit for interacting with Claude Code and OpenCode",
   "module": "index.ts",
   "type": "module",