@khuongdo/vibe-kanban 0.1.45

package/README.md

@@ -0,0 +1,182 @@
+# Vibe Kanban
+
+> A visual project management tool for developers that integrates with git repositories and coding agents like Claude Code and Amp.
+
+## Quick Start
+
+Run vibe kanban instantly without installation:
+
+```bash
+npx vibe-kanban
+```
+
+This will launch the application locally and open it in your browser automatically.
+
+Helpful entrypoints:
+
+```bash
+npx vibe-kanban --help
+npx vibe-kanban --version
+npx vibe-kanban review --help
+npx vibe-kanban mcp --help
+```
+
+## What is Vibe Kanban?
+
+Vibe Kanban is a modern project management tool designed specifically for developers. It helps you organize your coding projects with kanban-style task management while providing powerful integrations with git repositories and AI coding agents.
+
+### ✨ Key Features
+
+**🗂️ Project Management**
+
+- Add git repositories as projects (existing or create new ones)
+- Automatic git integration and repository validation
+- Project search functionality across all files
+- Custom setup and development scripts per project
+
+**📋 Task Management**
+
+- Create and manage tasks with kanban-style boards
+- Task status tracking (Todo, In Progress, Done)
+- Rich task descriptions and notes
+- Task execution with multiple AI agents
+
+**🤖 AI Agent Integration**
+
+- **Claude**: Advanced AI coding assistant
+- **Amp**: Powerful development agent
+- **Echo**: Simple testing/debugging agent
+- Create tasks and immediately start agent execution
+- Follow-up task execution for iterative development
+
+**⚡ Development Workflow**
+
+- Create isolated git worktrees for each task attempt
+- View diffs of changes made by agents
+- Merge successful changes back to main branch
+- Rebase task branches to stay up-to-date
+- Manual file editing and deletion
+- Integrated development server support
+
+**🎛️ Developer Tools**
+
+- Browse and validate git repositories from filesystem
+- Open task worktrees in your preferred editor (VS Code, Cursor, Windsurf, IntelliJ, Zed)
+- Real-time execution monitoring and process control
+- Stop running processes individually or all at once
+- Sound notifications for task completion
+
+## How It Works
+
+1. **Add Projects**: Import existing git repositories or create new ones
+2. **Create Tasks**: Define what needs to be built or fixed
+3. **Execute with AI**: Let coding agents work on your tasks in isolated environments
+4. **Review Changes**: See exactly what was modified using git diffs
+5. **Merge Results**: Incorporate successful changes into your main codebase
+
+## Core Functionality
+
+Vibe Kanban provides a complete project management experience with these key capabilities:
+
+**Project Repository Management**
+
+- Full CRUD operations for managing coding projects
+- Automatic git repository detection and validation
+- Initialize new repositories or import existing ones
+- Project-wide file search functionality
+
+**Task Lifecycle Management**
+
+- Create, update, and delete tasks with rich descriptions
+- Track task progress through customizable status workflows
+- One-click task creation with immediate AI agent execution
+- Task attempt tracking with detailed execution history
+
+**AI Agent Execution Environment**
+
+- Isolated git worktrees for safe code experimentation
+- Real-time execution monitoring and activity logging
+- Process management with ability to stop individual or all processes
+- Support for follow-up executions to iterate on solutions
+
+**Code Change Management**
+
+- View detailed diffs of all changes made during task execution
+- Branch status monitoring to track divergence from main
+- One-click merging of successful changes back to main branch
+- Automatic rebasing to keep task branches up-to-date
+- Manual file deletion and cleanup capabilities
+
+**Development Integration**
+
+- Open task worktrees directly in your preferred code editor
+- Start and manage development servers for testing changes
+- Browse local filesystem to add new projects
+- Health monitoring for service availability
+
+## Configuration
+
+Vibe Kanban supports customization through its configuration system:
+
+- **Editor Integration**: Choose your preferred code editor
+- **Sound Notifications**: Customize completion sounds
+- **Project Defaults**: Set default setup and development scripts
+
+## Technical Architecture
+
+- **Backend**: Rust with Axum web framework
+- **Frontend**: React with TypeScript
+- **Database**: SQLite for local data storage
+- **Git Integration**: Native git operations for repository management
+- **Process Management**: Tokio-based async execution monitoring
+
+## Requirements
+
+- Node.js (for npx execution)
+- Git (for repository operations)
+- Your preferred code editor (optional, for opening task worktrees)
+
+## Supported Platforms
+
+- Linux x64
+- Windows x64
+- macOS x64 (Intel)
+- macOS ARM64 (Apple Silicon)
+
+## Use Cases
+
+**🔧 Bug Fixes**
+
+- Create a task describing the bug
+- Let an AI agent analyze and fix the issue
+- Review the proposed changes
+- Merge if satisfied, or provide follow-up instructions
+
+**✨ Feature Development**
+
+- Break down features into manageable tasks
+- Use agents for initial implementation
+- Iterate with follow-up executions
+- Test using integrated development servers
+
+**🚀 Project Setup**
+
+- Bootstrap new projects with AI assistance
+- Set up development environments
+- Configure build and deployment scripts
+
+**📚 Code Documentation**
+
+- Generate documentation for existing code
+- Create README files and API documentation
+- Maintain up-to-date project information
+
+---
+
+**Ready to supercharge your development workflow?**
+
+```bash
+npx vibe-kanban
+```
+
+_Start managing your projects with the power of AI coding agents today!_

package/bin/cli.js

@@ -0,0 +1,738 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "@khuongdo/vibe-kanban",
+      private: false,
+      version: "0.1.45",
+      main: "index.js",
+      bin: {
+        "vibe-kanban": "bin/cli.js"
+      },
+      scripts: {
+        build: 'esbuild src/cli.ts --bundle --platform=node --target=node20 --format=cjs --outfile=bin/cli.js --external:adm-zip --banner:js="#!/usr/bin/env node"',
+        check: "tsc --noEmit -p tsconfig.json"
+      },
+      keywords: [],
+      author: "bloop",
+      repository: {
+        type: "git",
+        url: "https://github.com/khuongdo/vibe-kanban"
+      },
+      engines: {
+        node: ">=20.19.0"
+      },
+      license: "",
+      description: "NPX wrapper around vibe-kanban and vibe-kanban-mcp",
+      devDependencies: {
+        esbuild: "^0.27.2"
+      },
+      dependencies: {
+        "adm-zip": "^0.5.16",
+        cac: "^7.0.0"
+      },
+      files: [
+        "bin",
+        "dist"
+      ]
+    };
+  }
+});
+
+// src/cli.ts
+var import_child_process2 = require("child_process");
+var import_path3 = __toESM(require("path"));
+var import_fs3 = __toESM(require("fs"));
+var import_cac = require("cac");
+
+// src/download.ts
+var import_https = __toESM(require("https"));
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_crypto = __toESM(require("crypto"));
+var import_os = __toESM(require("os"));
+var R2_BASE_URL = "__R2_PUBLIC_URL__";
+var BINARY_TAG = "__BINARY_TAG__";
+var CACHE_DIR = import_path.default.join(import_os.default.homedir(), ".vibe-kanban", "bin");
+var LOCAL_DIST_DIR = import_path.default.join(__dirname, "..", "dist");
+var LOCAL_DEV_MODE = import_fs.default.existsSync(LOCAL_DIST_DIR) || process.env.VIBE_KANBAN_LOCAL === "1";
+function fetchJson(url) {
+  return new Promise((resolve, reject) => {
+    import_https.default.get(url, (res) => {
+      if (res.statusCode === 301 || res.statusCode === 302) {
+        return fetchJson(res.headers.location).then(resolve).catch(reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} fetching ${url}`));
+      }
+      let data = "";
+      res.on("data", (chunk) => data += chunk);
+      res.on("end", () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          reject(new Error(`Failed to parse JSON from ${url}`));
+        }
+      });
+    }).on("error", reject);
+  });
+}
+function downloadFile(url, destPath, expectedSha256, onProgress) {
+  const tempPath = destPath + ".tmp";
+  return new Promise((resolve, reject) => {
+    const file = import_fs.default.createWriteStream(tempPath);
+    const hash = import_crypto.default.createHash("sha256");
+    const cleanup = () => {
+      try {
+        import_fs.default.unlinkSync(tempPath);
+      } catch {
+      }
+    };
+    import_https.default.get(url, (res) => {
+      if (res.statusCode === 301 || res.statusCode === 302) {
+        file.close();
+        cleanup();
+        return downloadFile(
+          res.headers.location,
+          destPath,
+          expectedSha256,
+          onProgress
+        ).then(resolve).catch(reject);
+      }
+      if (res.statusCode !== 200) {
+        file.close();
+        cleanup();
+        return reject(
+          new Error(`HTTP ${res.statusCode} downloading ${url}`)
+        );
+      }
+      const totalSize = parseInt(
+        res.headers["content-length"] || "0",
+        10
+      );
+      let downloadedSize = 0;
+      res.on("data", (chunk) => {
+        downloadedSize += chunk.length;
+        hash.update(chunk);
+        if (onProgress) onProgress(downloadedSize, totalSize);
+      });
+      res.pipe(file);
+      file.on("finish", () => {
+        file.close();
+        const actualSha256 = hash.digest("hex");
+        if (expectedSha256 && actualSha256 !== expectedSha256) {
+          cleanup();
+          reject(
+            new Error(
+              `Checksum mismatch: expected ${expectedSha256}, got ${actualSha256}`
+            )
+          );
+        } else {
+          try {
+            import_fs.default.renameSync(tempPath, destPath);
+            resolve(destPath);
+          } catch (err) {
+            cleanup();
+            reject(err);
+          }
+        }
+      });
+    }).on("error", (err) => {
+      file.close();
+      cleanup();
+      reject(err);
+    });
+  });
+}
+async function ensureBinary(platform2, binaryName, onProgress) {
+  if (LOCAL_DEV_MODE) {
+    const localZipPath = import_path.default.join(
+      LOCAL_DIST_DIR,
+      platform2,
+      `${binaryName}.zip`
+    );
+    if (import_fs.default.existsSync(localZipPath)) {
+      return localZipPath;
+    }
+    throw new Error(
+      `Local binary not found: ${localZipPath}
+Run ./local-build.sh first to build the binaries.`
+    );
+  }
+  const cacheDir = import_path.default.join(CACHE_DIR, BINARY_TAG, platform2);
+  const zipPath = import_path.default.join(cacheDir, `${binaryName}.zip`);
+  if (import_fs.default.existsSync(zipPath)) return zipPath;
+  import_fs.default.mkdirSync(cacheDir, { recursive: true });
+  const manifest = await fetchJson(
+    `${R2_BASE_URL}/binaries/${BINARY_TAG}/manifest.json`
+  );
+  const binaryInfo = manifest.platforms?.[platform2]?.[binaryName];
+  if (!binaryInfo) {
+    throw new Error(
+      `Binary ${binaryName} not available for ${platform2}`
+    );
+  }
+  const url = `${R2_BASE_URL}/binaries/${BINARY_TAG}/${platform2}/${binaryName}.zip`;
+  await downloadFile(url, zipPath, binaryInfo.sha256, onProgress);
+  return zipPath;
+}
+var DESKTOP_CACHE_DIR = import_path.default.join(
+  import_os.default.homedir(),
+  ".vibe-kanban",
+  "desktop"
+);
+async function ensureDesktopBundle(tauriPlatform, onProgress) {
+  if (LOCAL_DEV_MODE) {
+    const localDir = import_path.default.join(LOCAL_DIST_DIR, "tauri", tauriPlatform);
+    if (import_fs.default.existsSync(localDir)) {
+      const files = import_fs.default.readdirSync(localDir);
+      const archive = files.find(
+        (f) => f.endsWith(".tar.gz") || f.endsWith("-setup.exe")
+      );
+      return {
+        dir: localDir,
+        archivePath: archive ? import_path.default.join(localDir, archive) : null,
+        type: null
+      };
+    }
+    throw new Error(
+      `Local desktop bundle not found: ${localDir}
+Run './local-build.sh --desktop' first to build the Tauri app.`
+    );
+  }
+  const cacheDir = import_path.default.join(
+    DESKTOP_CACHE_DIR,
+    BINARY_TAG,
+    tauriPlatform
+  );
+  const sentinelPath = import_path.default.join(cacheDir, ".installed");
+  if (import_fs.default.existsSync(sentinelPath)) {
+    return { dir: cacheDir, archivePath: null, type: null };
+  }
+  import_fs.default.mkdirSync(cacheDir, { recursive: true });
+  const manifest = await fetchJson(
+    `${R2_BASE_URL}/binaries/${BINARY_TAG}/tauri/desktop-manifest.json`
+  );
+  const platformInfo = manifest.platforms?.[tauriPlatform];
+  if (!platformInfo) {
+    throw new Error(
+      `Desktop app not available for platform: ${tauriPlatform}`
+    );
+  }
+  const destPath = import_path.default.join(cacheDir, platformInfo.file);
+  if (!import_fs.default.existsSync(destPath)) {
+    const url = `${R2_BASE_URL}/binaries/${BINARY_TAG}/tauri/${tauriPlatform}/${platformInfo.file}`;
+    await downloadFile(url, destPath, platformInfo.sha256, onProgress);
+  }
+  return {
+    archivePath: destPath,
+    dir: cacheDir,
+    type: platformInfo.type
+  };
+}
+async function getLatestVersion() {
+  const manifest = await fetchJson(
+    `${R2_BASE_URL}/binaries/manifest.json`
+  );
+  return manifest.latest;
+}
+
+// src/desktop.ts
+var import_child_process = require("child_process");
+var import_path2 = __toESM(require("path"));
+var import_fs2 = __toESM(require("fs"));
+var import_os2 = __toESM(require("os"));
+var PLATFORM_MAP = {
+  "macos-arm64": "darwin-aarch64",
+  "macos-x64": "darwin-x86_64",
+  "linux-x64": "linux-x86_64",
+  "linux-arm64": "linux-aarch64",
+  "windows-x64": "windows-x86_64",
+  "windows-arm64": "windows-aarch64"
+};
+function getTauriPlatform(npxPlatformDir) {
+  return PLATFORM_MAP[npxPlatformDir] || null;
+}
+function extractTarGz(archivePath, destDir) {
+  (0, import_child_process.execSync)(`tar -xzf "${archivePath}" -C "${destDir}"`, {
+    stdio: "pipe"
+  });
+}
+function writeSentinel(dir, meta) {
+  import_fs2.default.writeFileSync(
+    import_path2.default.join(dir, ".installed"),
+    JSON.stringify(meta)
+  );
+}
+function readSentinel(dir) {
+  const sentinelPath = import_path2.default.join(dir, ".installed");
+  if (!import_fs2.default.existsSync(sentinelPath)) return null;
+  try {
+    return JSON.parse(
+      import_fs2.default.readFileSync(sentinelPath, "utf-8")
+    );
+  } catch {
+    return null;
+  }
+}
+function tryCopyApp(srcAppPath, destDir) {
+  try {
+    const appName = import_path2.default.basename(srcAppPath);
+    const destAppPath = import_path2.default.join(destDir, appName);
+    import_fs2.default.mkdirSync(destDir, { recursive: true });
+    if (import_fs2.default.existsSync(destAppPath)) {
+      import_fs2.default.rmSync(destAppPath, { recursive: true, force: true });
+    }
+    (0, import_child_process.execSync)(`cp -R "${srcAppPath}" "${destAppPath}"`, {
+      stdio: "pipe"
+    });
+    return destAppPath;
+  } catch {
+    return null;
+  }
+}
+async function installAndLaunchMacOS(bundleInfo) {
+  const { archivePath, dir } = bundleInfo;
+  const sentinel = readSentinel(dir);
+  if (sentinel?.appPath && import_fs2.default.existsSync(sentinel.appPath)) {
+    return launchMacOSApp(sentinel.appPath);
+  }
+  if (!archivePath || !import_fs2.default.existsSync(archivePath)) {
+    throw new Error("No archive to extract for macOS desktop app");
+  }
+  extractTarGz(archivePath, dir);
+  const appName = import_fs2.default.readdirSync(dir).find((f) => f.endsWith(".app"));
+  if (!appName) {
+    throw new Error(
+      `No .app bundle found in ${dir} after extraction`
+    );
+  }
+  const extractedAppPath = import_path2.default.join(dir, appName);
+  const userApplications = import_path2.default.join(import_os2.default.homedir(), "Applications");
+  const finalAppPath = tryCopyApp(extractedAppPath, "/Applications") ?? tryCopyApp(extractedAppPath, userApplications) ?? extractedAppPath;
+  if (finalAppPath !== extractedAppPath) {
+    try {
+      import_fs2.default.rmSync(extractedAppPath, { recursive: true, force: true });
+    } catch {
+    }
+  }
+  try {
+    (0, import_child_process.execSync)(`xattr -rd com.apple.quarantine "${finalAppPath}"`, {
+      stdio: "pipe"
+    });
+  } catch {
+  }
+  writeSentinel(dir, { type: "app-tar-gz", appPath: finalAppPath });
+  return launchMacOSApp(finalAppPath);
+}
+function launchMacOSApp(appPath) {
+  const appName = import_path2.default.basename(appPath);
+  console.error(`Launching ${appName}...`);
+  const proc = (0, import_child_process.spawn)("open", ["--wait-apps", appPath], {
+    stdio: "inherit"
+  });
+  return new Promise((resolve) => {
+    proc.on("exit", (code) => resolve(code || 0));
+  });
+}
+async function installAndLaunchLinux(bundleInfo) {
+  const { archivePath, dir } = bundleInfo;
+  const sentinel = readSentinel(dir);
+  if (sentinel?.appPath && import_fs2.default.existsSync(sentinel.appPath)) {
+    return launchLinuxAppImage(sentinel.appPath);
+  }
+  if (!archivePath || !import_fs2.default.existsSync(archivePath)) {
+    throw new Error("No archive to extract for Linux desktop app");
+  }
+  extractTarGz(archivePath, dir);
+  const appImage = import_fs2.default.readdirSync(dir).find((f) => f.endsWith(".AppImage"));
+  if (!appImage) {
+    throw new Error(`No .AppImage found in ${dir} after extraction`);
+  }
+  const appImagePath = import_path2.default.join(dir, appImage);
+  import_fs2.default.chmodSync(appImagePath, 493);
+  writeSentinel(dir, {
+    type: "appimage-tar-gz",
+    appPath: appImagePath
+  });
+  return launchLinuxAppImage(appImagePath);
+}
+function launchLinuxAppImage(appImagePath) {
+  const appImage = import_path2.default.basename(appImagePath);
+  console.error(`Launching ${appImage}...`);
+  const proc = (0, import_child_process.spawn)(appImagePath, [], {
+    stdio: "inherit",
+    detached: false
+  });
+  return new Promise((resolve) => {
+    proc.on("exit", (code) => resolve(code || 0));
+  });
+}
+async function installAndLaunchWindows(bundleInfo) {
+  const { dir } = bundleInfo;
+  const sentinel = readSentinel(dir);
+  if (sentinel?.appPath) {
+    const appExe2 = import_path2.default.join(sentinel.appPath, "Vibe Kanban.exe");
+    if (import_fs2.default.existsSync(appExe2)) {
+      return launchWindowsApp(appExe2);
+    }
+  }
+  const files = import_fs2.default.readdirSync(dir);
+  const installer = files.find(
+    (f) => f.endsWith("-setup.exe") || f.endsWith(".exe") && f !== ".installed"
+  );
+  if (!installer) {
+    throw new Error(`No installer found in ${dir}`);
+  }
+  const installerPath = import_path2.default.join(dir, installer);
+  const installDir = import_path2.default.join(dir, "app");
+  console.error("Installing Vibe Kanban...");
+  try {
+    (0, import_child_process.execSync)(`"${installerPath}" /S /D="${installDir}"`, {
+      stdio: "inherit",
+      timeout: 12e4
+    });
+  } catch {
+    console.error(
+      "Silent install failed, launching interactive installer..."
+    );
+    (0, import_child_process.execSync)(`"${installerPath}"`, { stdio: "inherit" });
+    const defaultDir = import_path2.default.join(
+      process.env.LOCALAPPDATA || "",
+      "vibe-kanban"
+    );
+    if (import_fs2.default.existsSync(import_path2.default.join(defaultDir, "Vibe Kanban.exe"))) {
+      writeSentinel(dir, {
+        type: "nsis-exe",
+        appPath: defaultDir
+      });
+      return launchWindowsApp(
+        import_path2.default.join(defaultDir, "Vibe Kanban.exe")
+      );
+    }
+    console.error(
+      "Installation complete. Please launch Vibe Kanban from your Start menu."
+    );
+    return 0;
+  }
+  writeSentinel(dir, { type: "nsis-exe", appPath: installDir });
+  const appExe = import_path2.default.join(installDir, "Vibe Kanban.exe");
+  if (import_fs2.default.existsSync(appExe)) {
+    return launchWindowsApp(appExe);
+  }
+  console.error(
+    "Installation complete. Please launch Vibe Kanban from your Start menu."
+  );
+  return 0;
+}
+function launchWindowsApp(appExe) {
+  console.error("Launching Vibe Kanban...");
+  (0, import_child_process.spawn)(appExe, [], { detached: true, stdio: "ignore" }).unref();
+  return 0;
+}
+async function installAndLaunch(bundleInfo, osPlatform) {
+  if (osPlatform === "darwin") {
+    return installAndLaunchMacOS(bundleInfo);
+  } else if (osPlatform === "linux") {
+    return installAndLaunchLinux(bundleInfo);
+  } else if (osPlatform === "win32") {
+    return installAndLaunchWindows(bundleInfo);
+  }
+  throw new Error(
+    `Desktop app not supported on platform: ${osPlatform}`
+  );
+}
+function cleanOldDesktopVersions(desktopBaseDir, currentTag) {
+  try {
+    const entries = import_fs2.default.readdirSync(desktopBaseDir, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      if (entry.isDirectory() && entry.name !== currentTag) {
+        const oldDir = import_path2.default.join(desktopBaseDir, entry.name);
+        try {
+          import_fs2.default.rmSync(oldDir, { recursive: true, force: true });
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+}
+
+// src/cli.ts
+var CLI_VERSION = require_package().version;
+function getEffectiveArch() {
+  const platform2 = process.platform;
+  const nodeArch = process.arch;
+  if (platform2 === "darwin") {
+    if (nodeArch === "arm64") return "arm64";
+    try {
+      const translated = (0, import_child_process2.execSync)("sysctl -in sysctl.proc_translated", {
+        encoding: "utf8"
+      }).trim();
+      if (translated === "1") return "arm64";
+    } catch {
+    }
+    return "x64";
+  }
+  if (/arm/i.test(nodeArch)) return "arm64";
+  if (platform2 === "win32") {
+    const pa = process.env.PROCESSOR_ARCHITECTURE || "";
+    const paw = process.env.PROCESSOR_ARCHITEW6432 || "";
+    if (/arm/i.test(pa) || /arm/i.test(paw)) return "arm64";
+  }
+  return "x64";
+}
+var platform = process.platform;
+var arch = getEffectiveArch();
+function getPlatformDir() {
+  if (platform === "linux" && arch === "x64") return "linux-x64";
+  if (platform === "linux" && arch === "arm64") return "linux-arm64";
+  if (platform === "win32" && arch === "x64") return "windows-x64";
+  if (platform === "win32" && arch === "arm64") return "windows-arm64";
+  if (platform === "darwin" && arch === "x64") return "macos-x64";
+  if (platform === "darwin" && arch === "arm64") return "macos-arm64";
+  console.error(`Unsupported platform: ${platform}-${arch}`);
+  console.error("Supported platforms:");
+  console.error("  - Linux x64");
+  console.error("  - Linux ARM64");
+  console.error("  - Windows x64");
+  console.error("  - Windows ARM64");
+  console.error("  - macOS x64 (Intel)");
+  console.error("  - macOS ARM64 (Apple Silicon)");
+  process.exit(1);
+}
+function getBinaryName(base) {
+  return platform === "win32" ? `${base}.exe` : base;
+}
+var platformDir = getPlatformDir();
+var versionCacheDir = LOCAL_DEV_MODE ? import_path3.default.join(LOCAL_DIST_DIR, platformDir) : import_path3.default.join(CACHE_DIR, BINARY_TAG, platformDir);
+function cleanOldVersions() {
+  try {
+    const entries = import_fs3.default.readdirSync(CACHE_DIR, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      if (entry.isDirectory() && entry.name !== BINARY_TAG) {
+        const oldDir = import_path3.default.join(CACHE_DIR, entry.name);
+        import_fs3.default.rmSync(oldDir, { recursive: true, force: true });
+      }
+    }
+  } catch {
+  }
+}
+function showProgress(downloaded, total) {
+  const percent = total ? Math.round(downloaded / total * 100) : 0;
+  const mb = (downloaded / (1024 * 1024)).toFixed(1);
+  const totalMb = total ? (total / (1024 * 1024)).toFixed(1) : "?";
+  process.stderr.write(
+    `\r   Downloading: ${mb}MB / ${totalMb}MB (${percent}%)`
+  );
+}
+function buildMcpArgs(args) {
+  return args.length > 0 ? args : ["--mode", "global"];
+}
+async function extractAndRun(baseName, launch) {
+  const binName = getBinaryName(baseName);
+  const binPath = import_path3.default.join(versionCacheDir, binName);
+  const zipPath = import_path3.default.join(versionCacheDir, `${baseName}.zip`);
+  try {
+    if (import_fs3.default.existsSync(binPath)) {
+      import_fs3.default.unlinkSync(binPath);
+    }
+  } catch (err) {
+    if (process.env.VIBE_KANBAN_DEBUG) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`Warning: Could not delete existing binary: ${msg}`);
+    }
+  }
+  if (!import_fs3.default.existsSync(zipPath)) {
+    console.error(`Downloading ${baseName}...`);
+    try {
+      await ensureBinary(platformDir, baseName, showProgress);
+      console.error("");
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`
+Download failed: ${msg}`);
+      process.exit(1);
+    }
+  }
+  if (!import_fs3.default.existsSync(binPath)) {
+    try {
+      const { default: AdmZip } = await import("adm-zip");
+      const zip = new AdmZip(zipPath);
+      zip.extractAllTo(versionCacheDir, true);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error("Extraction failed:", msg);
+      try {
+        import_fs3.default.unlinkSync(zipPath);
+      } catch {
+      }
+      process.exit(1);
+    }
+  }
+  if (!import_fs3.default.existsSync(binPath)) {
+    console.error(`Extracted binary not found at: ${binPath}`);
+    console.error(
+      "This usually indicates a corrupt download. Please try again."
+    );
+    process.exit(1);
+  }
+  if (!LOCAL_DEV_MODE) {
+    cleanOldVersions();
+  }
+  if (platform !== "win32") {
+    try {
+      import_fs3.default.chmodSync(binPath, 493);
+    } catch {
+    }
+  }
+  return launch(binPath);
+}
+function checkForUpdates() {
+  const hasValidR2Url = !R2_BASE_URL.startsWith("__");
+  if (LOCAL_DEV_MODE || !hasValidR2Url) {
+    return;
+  }
+  getLatestVersion().then((latest) => {
+    if (latest && latest !== CLI_VERSION) {
+      setTimeout(() => {
+        console.log(`
+Update available: ${CLI_VERSION} -> ${latest}`);
+        console.log(`Run: npx vibe-kanban@latest`);
+      }, 2e3);
+    }
+  }).catch(() => {
+  });
+}
+async function runMcp(args) {
+  await extractAndRun("vibe-kanban-mcp", (bin) => {
+    const proc = (0, import_child_process2.spawn)(bin, buildMcpArgs(args), {
+      stdio: "inherit"
+    });
+    proc.on("exit", (c) => process.exit(c || 0));
+    proc.on("error", (e) => {
+      console.error("MCP server error:", e.message);
+      process.exit(1);
+    });
+    process.on("SIGINT", () => {
+      proc.kill("SIGINT");
+    });
+    process.on("SIGTERM", () => proc.kill("SIGTERM"));
+  });
+}
+async function runReview(args) {
+  await extractAndRun("vibe-kanban-review", (bin) => {
+    const proc = (0, import_child_process2.spawn)(bin, args, { stdio: "inherit" });
+    proc.on("exit", (c) => process.exit(c || 0));
+    proc.on("error", (e) => {
+      console.error("Review CLI error:", e.message);
+      process.exit(1);
+    });
+  });
+}
+async function runMain(desktopMode) {
+  checkForUpdates();
+  const modeLabel = LOCAL_DEV_MODE ? " (local dev)" : "";
+  const tauriPlatform = getTauriPlatform(platformDir);
+  if (desktopMode && tauriPlatform) {
+    try {
+      console.log(
+        `Starting vibe-kanban desktop v${CLI_VERSION}${modeLabel}...`
+      );
+      const bundleInfo = await ensureDesktopBundle(tauriPlatform, showProgress);
+      console.error("");
+      if (!LOCAL_DEV_MODE) {
+        cleanOldDesktopVersions(DESKTOP_CACHE_DIR, BINARY_TAG);
+      }
+      const exitCode = await installAndLaunch(bundleInfo, platform);
+      process.exit(exitCode);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`Desktop app not available: ${msg}`);
+      console.error("Falling back to browser mode...");
+    }
+  }
+  console.log(`Starting vibe-kanban v${CLI_VERSION}${modeLabel}...`);
+  await extractAndRun("vibe-kanban", (bin) => {
+    (0, import_child_process2.execSync)(`"${bin}"`, { stdio: "inherit" });
+  });
+}
+function normalizeArgv(argv) {
+  const args = argv.slice(2);
+  const mcpFlagIndex = args.indexOf("--mcp");
+  if (mcpFlagIndex === -1) {
+    return argv;
+  }
+  const normalizedArgs = [
+    ...args.slice(0, mcpFlagIndex),
+    "mcp",
+    ...args.slice(mcpFlagIndex + 1)
+  ];
+  return [...argv.slice(0, 2), ...normalizedArgs];
+}
+function runOrExit(task) {
+  void task.catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error("Fatal error:", msg);
+    if (process.env.VIBE_KANBAN_DEBUG && err instanceof Error) {
+      console.error(err.stack);
+    }
+    process.exit(1);
+  });
+}
+async function main() {
+  import_fs3.default.mkdirSync(versionCacheDir, { recursive: true });
+  const cli = (0, import_cac.cac)("vibe-kanban");
+  cli.command("[...args]", "Launch the local vibe-kanban app").option("--desktop", "Launch the desktop app instead of browser mode").allowUnknownOptions().action((_args, options) => {
+    runOrExit(runMain(Boolean(options.desktop)));
+  });
+  cli.command("review [...args]", "Run the review CLI").allowUnknownOptions().action((args) => {
+    runOrExit(runReview(args));
+  });
+  cli.command("mcp [...args]", "Run the MCP server").allowUnknownOptions().action((args) => {
+    runOrExit(runMcp(args));
+  });
+  cli.help();
+  cli.version(CLI_VERSION);
+  cli.parse(normalizeArgv(process.argv));
+}
+main().catch((err) => {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error("Fatal error:", msg);
+  if (process.env.VIBE_KANBAN_DEBUG && err instanceof Error) {
+    console.error(err.stack);
+  }
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@khuongdo/vibe-kanban",
+  "private": false,
+  "version": "0.1.45",
+  "main": "index.js",
+  "bin": {
+    "vibe-kanban": "bin/cli.js"
+  },
+  "scripts": {
+    "build": "esbuild src/cli.ts --bundle --platform=node --target=node20 --format=cjs --outfile=bin/cli.js --external:adm-zip --banner:js=\"#!/usr/bin/env node\"",
+    "check": "tsc --noEmit -p tsconfig.json"
+  },
+  "keywords": [],
+  "author": "bloop",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/khuongdo/vibe-kanban"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "license": "",
+  "description": "NPX wrapper around vibe-kanban and vibe-kanban-mcp",
+  "devDependencies": {
+    "esbuild": "^0.27.2"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "cac": "^7.0.0"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ]
+}