vibe-cokit 1.9.0 → 1.11.0

package/dist/cli.js

@@ -728,12 +728,12 @@ var dist_default = cac;
 var version = "0.1.0";
 
 // src/commands/init.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 
 // src/utils/config.ts
-import { homedir } from "os";
-import { join } from "path";
-import { mkdir, cp, rm, stat, readdir, readFile, writeFile, appendFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+import { mkdir as mkdir2, cp, rm, stat as stat2, readdir as readdir2, readFile, writeFile, appendFile as appendFile2 } from "fs/promises";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
 // node_modules/lodash-es/_arrayFilter.js
@@ -2301,10 +2301,108 @@ var some_default = some;
 // src/utils/helpers.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
+
+// src/utils/logger.ts
+import { homedir } from "os";
+import { join } from "path";
+import { mkdir, readdir, stat, unlink, appendFile } from "fs/promises";
+var DEFAULT_LOG_DIR = join(homedir(), ".vk", "logs");
+var RETENTION_DAYS = 7;
+var LOG_FILE_PATTERN = /^vk-\d{4}-\d{2}-\d{2}\.log$/;
+function formatDate(date) {
+  return date.toISOString().split("T")[0];
+}
+function padLevel(level) {
+  return level.toUpperCase().padEnd(5);
+}
+function formatEntry(level, command, msg, err) {
+  const ts = new Date().toISOString();
+  let entry = `[${ts}] ${padLevel(level)} [${command}] ${msg}
+`;
+  if (err instanceof Error && err.stack) {
+    const stackLines = err.stack.split(`
+`).slice(1).map((l) => `    ${l.trim()}`).join(`
+`);
+    entry += `  Stack: ${err.message}
+${stackLines}
+`;
+  }
+  return entry;
+}
+
+class Logger {
+  logDir;
+  logFilePath = null;
+  debugMode = false;
+  ready = false;
+  constructor(logDir) {
+    this.logDir = logDir ?? DEFAULT_LOG_DIR;
+  }
+  async init(debugMode = false) {
+    this.debugMode = debugMode;
+    try {
+      await mkdir(this.logDir, { recursive: true });
+      this.logFilePath = join(this.logDir, `vk-${formatDate(new Date)}.log`);
+      await this.runRotation();
+      this.ready = true;
+    } catch {}
+  }
+  async runRotation() {
+    try {
+      const files = await readdir(this.logDir);
+      const cutoff = Date.now() - RETENTION_DAYS * 24 * 60 * 60 * 1000;
+      for (const file of files) {
+        if (!LOG_FILE_PATTERN.test(file))
+          continue;
+        const filePath = join(this.logDir, file);
+        try {
+          const s = await stat(filePath);
+          if (s.mtimeMs < cutoff) {
+            await unlink(filePath);
+          }
+        } catch {}
+      }
+    } catch {}
+  }
+  async write(level, command, msg, err) {
+    if (!this.ready || !this.logFilePath)
+      return;
+    if (!this.debugMode && level === "debug")
+      return;
+    try {
+      const entry = formatEntry(level, command, msg, err);
+      await appendFile(this.logFilePath, entry, "utf-8");
+    } catch {}
+  }
+  async debug(command, msg) {
+    return this.write("debug", command, msg);
+  }
+  async info(command, msg) {
+    return this.write("info", command, msg);
+  }
+  async warn(command, msg) {
+    return this.write("warn", command, msg);
+  }
+  async error(command, msg, err) {
+    return this.write("error", command, msg, err);
+  }
+  getLogDir() {
+    return this.logDir;
+  }
+  getLogFilePath() {
+    return this.logFilePath;
+  }
+}
+var logger = new Logger;
+
+// src/utils/helpers.ts
 var exec = promisify(execFile);
 function getErrorMsg(err) {
   return err instanceof Error ? err.message : String(err);
 }
+function logError(command, err) {
+  logger.error(command, getErrorMsg(err), err).catch(() => {});
+}
 async function checkBin(name) {
   try {
     await exec(name, ["--version"]);
@@ -2378,12 +2476,12 @@ var exec2 = promisify2(execFile2);
 var REPO = "vibe-cokit/claude-code";
 var ANTIGRAVITY_REPO = "vibe-cokit/antigravity";
 var SKILLS_REPO = "vibe-cokit/skills";
-var CLAUDE_DIR = join(homedir(), ".claude");
-var CLAUDE_SKILLS_DIR = join(CLAUDE_DIR, "skills");
-var ANTIGRAVITY_SKILLS_DIR = join(homedir(), ".gemini", "antigravity", "skills");
+var CLAUDE_DIR = join2(homedir2(), ".claude");
+var CLAUDE_SKILLS_DIR = join2(CLAUDE_DIR, "skills");
+var ANTIGRAVITY_SKILLS_DIR = join2(homedir2(), ".gemini", "antigravity", "skills");
 var CONFIG_FOLDERS = ["agents", "commands", "hooks", "prompts", "workflows"];
-var TEMP_DIR = join(homedir(), ".vibe-cokit-tmp");
-var SETTINGS_PATH = join(CLAUDE_DIR, "settings.json");
+var TEMP_DIR = join2(homedir2(), ".vibe-cokit-tmp");
+var SETTINGS_PATH = join2(CLAUDE_DIR, "settings.json");
 function log(step) {
   console.log(`  \u2192 ${step}`);
 }
@@ -2403,7 +2501,7 @@ async function cloneRepo(tmpDir, repo = REPO) {
 }
 async function dirExists(path) {
   try {
-    const s = await stat(path);
+    const s = await stat2(path);
     return s.isDirectory();
   } catch {
     return false;
@@ -2411,26 +2509,26 @@ async function dirExists(path) {
 }
 async function fileExists(path) {
   try {
-    const s = await stat(path);
+    const s = await stat2(path);
     return s.isFile();
   } catch {
     return false;
   }
 }
 async function copyConfigFolders(srcDir) {
-  await mkdir(CLAUDE_DIR, { recursive: true });
+  await mkdir2(CLAUDE_DIR, { recursive: true });
   for (const folder of CONFIG_FOLDERS) {
-    const src = join(srcDir, folder);
+    const src = join2(srcDir, folder);
     if (await dirExists(src)) {
-      const dest = join(CLAUDE_DIR, folder);
+      const dest = join2(CLAUDE_DIR, folder);
       await cp(src, dest, { recursive: true, force: true });
       log(`Copied ${folder}/`);
     }
   }
 }
 async function copyClaudeMd(srcDir) {
-  const src = join(srcDir, "CLAUDE.md");
-  const dest = join(process.cwd(), "CLAUDE.md");
+  const src = join2(srcDir, "CLAUDE.md");
+  const dest = join2(process.cwd(), "CLAUDE.md");
   if (await fileExists(src)) {
     await cp(src, dest, { force: true });
   }
@@ -2450,8 +2548,11 @@ async function getCommitSha(tmpDir) {
 }
 async function readSettings() {
   const file = Bun.file(SETTINGS_PATH);
-  if (await file.exists())
-    return file.json();
+  if (await file.exists()) {
+    const text = await file.text();
+    const stripped = text.replace(/^\s*\/\/.*$/gm, "").replace(/,(\s*[}\]])/g, "$1");
+    return JSON.parse(stripped);
+  }
   return {};
 }
 async function writeSettings(settings) {
@@ -2480,12 +2581,12 @@ async function getRemoteSha(ref, repo = REPO) {
   return sha;
 }
 async function copySkillFolders(srcDir, destDir = CLAUDE_SKILLS_DIR) {
-  await mkdir(destDir, { recursive: true });
-  const entries = await readdir(srcDir, { withFileTypes: true });
+  await mkdir2(destDir, { recursive: true });
+  const entries = await readdir2(srcDir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isDirectory() && !entry.name.startsWith(".")) {
-      const src = join(srcDir, entry.name);
-      const dest = join(destDir, entry.name);
+      const src = join2(srcDir, entry.name);
+      const dest = join2(destDir, entry.name);
       await cp(src, dest, { recursive: true, force: true });
       log(`Copied skill: ${entry.name}/`);
     }
@@ -2513,8 +2614,11 @@ async function upgradeCli() {
   const { stdout: installedRaw } = await exec2("bun", ["pm", "ls", "-g"]);
   const match = installedRaw.match(/vibe-cokit@(\S+)/);
   const currentVersion = match?.[1] ?? "0.0.0";
-  const { stdout: latestRaw } = await exec2("npm", ["view", "vibe-cokit", "version"]);
-  const latestVersion = latestRaw.trim();
+  const res = await fetch("https://registry.npmjs.org/vibe-cokit/latest");
+  if (!res.ok)
+    throw new Error(`npm registry returned ${res.status}`);
+  const data = await res.json();
+  const latestVersion = data.version;
   if (currentVersion === latestVersion) {
     return { upgraded: false, from: currentVersion, to: latestVersion };
   }
@@ -2522,19 +2626,19 @@ async function upgradeCli() {
   return { upgraded: true, from: currentVersion, to: latestVersion };
 }
 async function copyAgentFolder(srcDir) {
-  const dest = join(process.cwd(), ".agents");
-  await mkdir(dest, { recursive: true });
-  const entries = await readdir(srcDir, { withFileTypes: true });
+  const dest = join2(process.cwd(), ".agents");
+  await mkdir2(dest, { recursive: true });
+  const entries = await readdir2(srcDir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.name.startsWith(".git"))
       continue;
-    const src = join(srcDir, entry.name);
-    const target = join(dest, entry.name);
+    const src = join2(srcDir, entry.name);
+    const target = join2(dest, entry.name);
     await cp(src, target, { recursive: true, force: true });
   }
 }
 async function ensureGitignore(entry) {
-  const gitignorePath = join(process.cwd(), ".gitignore");
+  const gitignorePath = join2(process.cwd(), ".gitignore");
   try {
     const content = await readFile(gitignorePath, "utf-8");
     const lines = content.split(/\r?\n/);
@@ -2543,7 +2647,7 @@ async function ensureGitignore(entry) {
     const separator = content.endsWith(`
 `) ? "" : `
 `;
-    await appendFile(gitignorePath, `${separator}${entry}
+    await appendFile2(gitignorePath, `${separator}${entry}
 `);
   } catch {
     await writeFile(gitignorePath, `${entry}
@@ -2570,7 +2674,7 @@ async function initCommand(agent) {
   }
 }
 async function initClaudeCode() {
-  const tmpDir = join2(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit init (claude-code)
@@ -2595,6 +2699,7 @@ vibe-cokit init (claude-code)
     console.log(`  Claude:  ./CLAUDE.md
 `);
   } catch (err) {
+    logError("init", err);
     console.error(`
 \u2717 Init failed: ${getErrorMsg(err)}
 `);
@@ -2604,7 +2709,7 @@ vibe-cokit init (claude-code)
   }
 }
 async function initAntigravity() {
-  const tmpDir = join2(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit init (antigravity)
@@ -2615,12 +2720,12 @@ vibe-cokit init (antigravity)
     await cloneRepo(tmpDir, ANTIGRAVITY_REPO);
     log("Copying agent config to .agents/...");
     await copyAgentFolder(tmpDir);
-    const skillsTmpDir = join2(TEMP_DIR, crypto.randomUUID());
+    const skillsTmpDir = join3(TEMP_DIR, crypto.randomUUID());
     try {
       log("Cloning skills repository...");
       await cloneRepo(skillsTmpDir, SKILLS_REPO);
       log("Installing skills to .agent/skills/...");
-      await copySkillFolders(skillsTmpDir, join2(process.cwd(), ".agent", "skills"));
+      await copySkillFolders(skillsTmpDir, join3(process.cwd(), ".agent", "skills"));
     } finally {
       await cleanup(skillsTmpDir);
     }
@@ -2636,6 +2741,7 @@ vibe-cokit init (antigravity)
     console.log(`  Agent:   ./.agents/
 `);
   } catch (err) {
+    logError("init", err);
     console.error(`
 \u2717 Init failed: ${getErrorMsg(err)}
 `);
@@ -2646,7 +2752,7 @@ vibe-cokit init (antigravity)
 }
 
 // src/commands/update.ts
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { execFile as execFile3 } from "child_process";
 import { promisify as promisify3 } from "util";
 var exec3 = promisify3(execFile3);
@@ -2672,8 +2778,10 @@ vibe-cokit update${agentType ? ` (${agentType})` : ""}
       } else {
         log(`CLI: v${from} (latest)`);
       }
-    } catch {
-      log("CLI upgrade skipped (npm registry unavailable)");
+    } catch (err) {
+      const reason = getErrorMsg(err);
+      logError("update:cli", err);
+      log(`CLI upgrade skipped: ${reason}`);
     }
     if (agentType) {
       log("Verifying prerequisites...");
@@ -2692,6 +2800,7 @@ vibe-cokit update${agentType ? ` (${agentType})` : ""}
 \u2713 vibe-cokit update complete!
 `);
   } catch (err) {
+    logError("update", err);
     const msg = getErrorMsg(err);
     console.error(`
 \u2717 Update failed: ${msg}
@@ -2704,7 +2813,7 @@ async function updateClaudeCode(ref) {
   await updateSkills(ref);
 }
 async function updateConfig(ref) {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking config version...");
     const currentSha = await getCurrentVersion();
@@ -2731,7 +2840,7 @@ async function updateConfig(ref) {
   }
 }
 async function updateSkills(ref, destDir) {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking skills version...");
     const currentSha = await getSkillsVersion();
@@ -2760,7 +2869,7 @@ async function updateSkills(ref, destDir) {
   }
 }
 async function updateAntigravity(ref) {
-  const tmpDir = join3(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join4(TEMP_DIR, crypto.randomUUID());
   try {
     log("Checking antigravity version...");
     const currentSha = await getAntigravityVersion();
@@ -2788,12 +2897,12 @@ async function updateAntigravity(ref) {
 }
 
 // src/commands/skills.ts
-import { join as join4 } from "path";
+import { join as join5 } 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 = join4(TEMP_DIR, crypto.randomUUID());
+  const tmpDir = join5(TEMP_DIR, crypto.randomUUID());
   try {
     console.log(`
 vibe-cokit skills
@@ -2829,6 +2938,7 @@ vibe-cokit skills
     console.log(`  Skills:  ~/.claude/skills/
 `);
   } catch (err) {
+    logError("skills", err);
     console.error(`
 \u2717 Skills setup failed: ${getErrorMsg(err)}
 `);
@@ -2924,12 +3034,12 @@ vibe-cokit v${version}`);
 }
 
 // src/commands/doctor.ts
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/utils/keyboard.ts
-import { homedir as homedir2, platform } from "os";
-import { join as join5, dirname, basename } from "path";
-import { readdir as readdir2, stat as stat2, cp as cp2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { homedir as homedir3, platform } from "os";
+import { join as join6, dirname, basename } from "path";
+import { readdir as readdir3, stat as stat3, cp as cp2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 var PATCH_MARKER = "/* Vietnamese IME fix */";
 var DEL_CHAR = "\x7F";
 function detectFileType(filePath) {
@@ -2939,19 +3049,19 @@ function detectFileType(filePath) {
   return "js";
 }
 async function findCliJs() {
-  const home = homedir2();
+  const home = homedir3();
   const isWin = platform() === "win32";
-  const nativePath = join5(home, ".local", "share", "claude", "versions");
+  const nativePath = join6(home, ".local", "share", "claude", "versions");
   try {
-    const s = await stat2(nativePath);
+    const s = await stat3(nativePath);
     if (s.isDirectory()) {
-      const entries = await readdir2(nativePath);
+      const entries = await readdir3(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 = join5(nativePath, ver);
+        const binPath = join6(nativePath, ver);
         try {
-          const bs = await stat2(binPath);
+          const bs = await stat3(binPath);
           if (bs.isFile())
             return binPath;
         } catch {}
@@ -2959,17 +3069,17 @@ async function findCliJs() {
     }
   } catch {}
   const searchDirs = isWin ? [
-    join5(process.env.LOCALAPPDATA ?? "", "npm-cache", "_npx"),
-    join5(process.env.APPDATA ?? "", "npm", "node_modules")
+    join6(process.env.LOCALAPPDATA ?? "", "npm-cache", "_npx"),
+    join6(process.env.APPDATA ?? "", "npm", "node_modules")
   ] : [
-    join5(home, ".npm", "_npx"),
-    join5(home, ".nvm", "versions", "node"),
+    join6(home, ".npm", "_npx"),
+    join6(home, ".nvm", "versions", "node"),
     "/usr/local/lib/node_modules",
     "/opt/homebrew/lib/node_modules"
   ];
   for (const dir of searchDirs) {
     try {
-      const s = await stat2(dir);
+      const s = await stat3(dir);
       if (!s.isDirectory())
         continue;
     } catch {
@@ -2986,15 +3096,15 @@ async function findCliJsRecursive(dir, depth, maxDepth) {
   if (depth >= maxDepth)
     return null;
   try {
-    const entries = await readdir2(dir, { withFileTypes: true });
+    const entries = await readdir3(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const fullPath = join5(dir, entry.name);
+      const fullPath = join6(dir, entry.name);
       if (entry.name === "@anthropic-ai") {
-        const cliJs = join5(fullPath, "claude-code", "cli.js");
+        const cliJs = join6(fullPath, "claude-code", "cli.js");
         try {
-          const s = await stat2(cliJs);
+          const s = await stat3(cliJs);
           if (s.isFile())
             return cliJs;
         } catch {}
@@ -3114,7 +3224,7 @@ function generateBinaryFix(block, vars) {
 async function patchCliJs(filePath) {
   const fileType = detectFileType(filePath);
   try {
-    await stat2(filePath);
+    await stat3(filePath);
   } catch {
     return { success: false, message: `File kh\xF4ng t\u1ED3n t\u1EA1i: ${filePath}` };
   }
@@ -3124,7 +3234,7 @@ async function patchCliJs(filePath) {
   }
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
   const backupDir = fileType === "binary" ? "/tmp" : dirname(filePath);
-  const backupPath = join5(backupDir, `${basename(filePath)}.backup-${timestamp}`);
+  const backupPath = join6(backupDir, `${basename(filePath)}.backup-${timestamp}`);
   await cp2(filePath, backupPath);
   try {
     const bugPattern = getBugPattern(fileType);
@@ -3177,8 +3287,8 @@ async function patchCliJs(filePath) {
   } catch (err) {
     try {
       await cp2(backupPath, filePath);
-      const { unlink } = await import("fs/promises");
-      await unlink(backupPath);
+      const { unlink: unlink2 } = await import("fs/promises");
+      await unlink2(backupPath);
     } catch {}
     return {
       success: false,
@@ -3268,7 +3378,7 @@ vibe-cokit doctor
     issues++;
   }
   for (const folder of CONFIG_FOLDERS) {
-    const path = join6(CLAUDE_DIR, folder);
+    const path = join7(CLAUDE_DIR, folder);
     if (await dirExists(path)) {
       console.log(`  \u2713 ~/.claude/${folder}/`);
     } else {
@@ -3282,7 +3392,7 @@ vibe-cokit doctor
     console.log(`  \u2717 ~/.claude/skills/ missing \u2014 run \`vk skills\``);
     issues++;
   }
-  const settingsPath = join6(CLAUDE_DIR, "settings.json");
+  const settingsPath = join7(CLAUDE_DIR, "settings.json");
   if (await fileExists(settingsPath)) {
     console.log(`  \u2713 ~/.claude/settings.json`);
   } else {
@@ -3307,7 +3417,7 @@ vibe-cokit doctor
   } else {
     console.log(`  \u26A0 Claude Code CLI: not found`);
   }
-  const claudeMdExists = await fileExists(join6(process.cwd(), "CLAUDE.md"));
+  const claudeMdExists = await fileExists(join7(process.cwd(), "CLAUDE.md"));
   console.log(`  Project CLAUDE.md: ${claudeMdExists ? "found" : "not found"}`);
   console.log();
   if (issues === 0) {
@@ -3320,7 +3430,7 @@ vibe-cokit doctor
 }
 
 // src/commands/doctor-fix.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 async function doctorFixCommand() {
   console.log(`
 vibe-cokit doctor fix
@@ -3329,18 +3439,19 @@ vibe-cokit doctor fix
     log("Verifying prerequisites...");
     await verifyPrerequisites();
   } catch (err) {
+    logError("doctor-fix", err);
     console.error(`
 \u2717 Cannot fix: ${getErrorMsg(err)}
 `);
     process.exit(1);
   }
   let fixed = 0;
-  const folderChecks = await Promise.all(CONFIG_FOLDERS.map((f) => dirExists(join7(CLAUDE_DIR, f))));
+  const folderChecks = await Promise.all(CONFIG_FOLDERS.map((f) => dirExists(join8(CLAUDE_DIR, f))));
   const configMissing = !await dirExists(CLAUDE_DIR) || some_default(folderChecks, (exists) => !exists) || !await getCurrentVersion();
-  const claudeMdPath = join7(process.cwd(), "CLAUDE.md");
+  const claudeMdPath = join8(process.cwd(), "CLAUDE.md");
   const claudeMdMissing = !await fileExists(claudeMdPath);
   if (configMissing || claudeMdMissing) {
-    const tmpDir = join7(TEMP_DIR, crypto.randomUUID());
+    const tmpDir = join8(TEMP_DIR, crypto.randomUUID());
     try {
       await cloneRepo(tmpDir);
       if (configMissing) {
@@ -3362,6 +3473,7 @@ vibe-cokit doctor fix
         log("CLAUDE.md: OK");
       }
     } catch (err) {
+      logError("doctor-fix", err);
       console.error(`  \u2717 Config/CLAUDE.md fix failed: ${getErrorMsg(err)}`);
     } finally {
       await cleanup(tmpDir);
@@ -3373,7 +3485,7 @@ vibe-cokit doctor fix
   const skillsMissing = !await dirExists(CLAUDE_SKILLS_DIR) || !await getSkillsVersion();
   if (skillsMissing) {
     log("Skills missing \u2014 installing...");
-    const tmpDir = join7(TEMP_DIR, crypto.randomUUID());
+    const tmpDir = join8(TEMP_DIR, crypto.randomUUID());
     try {
       await cloneRepo(tmpDir, SKILLS_REPO);
       await copySkillFolders(tmpDir);
@@ -3382,6 +3494,7 @@ vibe-cokit doctor fix
       log(`Skills installed (${sha.slice(0, 8)})`);
       fixed++;
     } catch (err) {
+      logError("doctor-fix", err);
       console.error(`  \u2717 Skills fix failed: ${getErrorMsg(err)}`);
     } finally {
       await cleanup(tmpDir);
@@ -3404,6 +3517,7 @@ vibe-cokit doctor fix
         console.error(`  \u2717 Keyboard fix failed: ${result.message}`);
       }
     } catch (err) {
+      logError("doctor-fix", err);
       console.error(`  \u2717 Keyboard fix failed: ${getErrorMsg(err)}`);
     }
   } else if (kbStatus.cliJsFound && kbStatus.isPatched) {
@@ -3491,6 +3605,7 @@ async function addModule(mod) {
     await exec5("claude", ["mcp", "add-json", mod.name, JSON.stringify(config)]);
     return true;
   } catch (err) {
+    logError("mcp", err);
     console.error(`  \u2717 Failed to add ${mod.name}: ${getErrorMsg(err)}`);
     return false;
   }
@@ -3505,6 +3620,7 @@ async function removeModule(name) {
       console.log(`  \u26A0 ${name} not configured, skipping`);
       return true;
     }
+    logError("mcp", err);
     console.error(`  \u2717 Failed to remove ${name}: ${msg}`);
     return false;
   }
@@ -3677,6 +3793,7 @@ async function addPlugin(plugin) {
   } catch (err) {
     const msg = getErrorMsg(err);
     if (!msg.includes("already installed")) {
+      logError("plugin", err);
       console.error(`  \u2717 Failed to install ${plugin.name}: ${msg}`);
       return false;
     }
@@ -3686,6 +3803,7 @@ async function addPlugin(plugin) {
   } catch (err) {
     const msg = getErrorMsg(err);
     if (!msg.includes("already enabled")) {
+      logError("plugin", err);
       console.error(`  \u2717 Failed to enable ${plugin.name}: ${msg}`);
       return false;
     }
@@ -3704,6 +3822,7 @@ async function removePlugin(name) {
       console.log(`  \u26A0 ${name} not installed, skipping`);
       return true;
     }
+    logError("plugin", err);
     console.error(`  \u2717 Failed to uninstall ${name}: ${msg}`);
     return false;
   }
@@ -3790,6 +3909,7 @@ Killing process on port ${port}...`);
 \u2713 No process running on port ${port}
 `);
     } else {
+      logError("tools", err);
       console.error(`
 \u2717 Failed to kill port ${port}: ${msg}
 `);
@@ -3837,7 +3957,78 @@ vibe-cokit tools
   }
 }
 
+// src/commands/logs.ts
+import { readdir as readdir4, unlink as unlink2 } from "fs/promises";
+import { join as join9 } from "path";
+var LOG_FILE_PATTERN2 = /^vk-\d{4}-\d{2}-\d{2}\.log$/;
+async function showLogs(lines) {
+  const logDir = logger.getLogDir();
+  let targetPath = logger.getLogFilePath();
+  if (targetPath && !await Bun.file(targetPath).exists()) {
+    targetPath = null;
+  }
+  if (!targetPath) {
+    try {
+      const files = (await readdir4(logDir)).filter((f) => LOG_FILE_PATTERN2.test(f)).sort().reverse();
+      if (files.length > 0) {
+        targetPath = join9(logDir, files[0]);
+      }
+    } catch {}
+  }
+  if (!targetPath) {
+    console.log(`
+No log files found. Logs are created when errors occur.`);
+    console.log(`Run 'vk init' or any other command that fails to generate a log.
+`);
+    return;
+  }
+  const content = await Bun.file(targetPath).text();
+  const allLines = content.split(`
+`);
+  const tail = allLines.slice(-lines).join(`
+`);
+  const fileName = targetPath.split("/").pop();
+  console.log(`
+--- ${fileName} (last ${lines} lines) ---`);
+  console.log(tail);
+}
+async function clearLogs() {
+  const logDir = logger.getLogDir();
+  let count = 0;
+  try {
+    const files = await readdir4(logDir);
+    for (const file of files) {
+      if (LOG_FILE_PATTERN2.test(file)) {
+        await unlink2(join9(logDir, file));
+        count++;
+      }
+    }
+  } catch {}
+  if (count > 0) {
+    console.log(`
+  \u2713 Cleared ${count} log file${count > 1 ? "s" : ""} from ${logDir}
+`);
+  } else {
+    console.log(`
+No log files to clear.
+`);
+  }
+}
+async function logsCommand(options) {
+  if (options.path) {
+    console.log(logger.getLogDir());
+    return;
+  }
+  if (options.clear) {
+    return clearLogs();
+  }
+  const lines = Number(options.tail) || 50;
+  return showLogs(lines);
+}
+
 // src/cli.ts
+var debugMode = process.argv.includes("--debug") || process.env["VK_DEBUG"] === "1";
+await logger.init(debugMode);
 var cli = dist_default("vibe-cokit");
 cli.command("", "A toolkit for interacting with Claude Code").action(() => {
   cli.outputHelp();
@@ -3861,6 +4052,8 @@ 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("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();
 cli.version(version);
 cli.parse();

package/package.json

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