@tdsoft-tech/aikit 0.1.4 → 0.1.6

package/dist/cli.js

@@ -169,7 +169,7 @@ __export(figma_mcp_exports, {
   FigmaMcpClient: () => FigmaMcpClient
 });
 import { writeFile as writeFile3, mkdir as mkdir3 } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { existsSync as existsSync2 } from "fs";
 var FigmaMcpClient;
 var init_figma_mcp = __esm({
@@ -179,10 +179,8 @@ var init_figma_mcp = __esm({
     init_logger();
     FigmaMcpClient = class {
       apiKey;
-      configManager;
-      constructor(apiKey, configManager) {
+      constructor(apiKey, _configManager) {
         this.apiKey = apiKey;
-        this.configManager = configManager;
       }
       /**
        * Fetch helper with simple retry/backoff for 429/5xx
@@ -328,7 +326,6 @@ ${text}`);
             if (fill.type === "SOLID" && fill.color) {
               const { r, g, b, a } = fill.color;
               const hex = this.rgbaToHex(r, g, b, a);
-              const name = node.name || "Color";
               if (!colorMap.has(hex)) {
                 colorMap.set(hex, hex);
               }
@@ -531,7 +528,7 @@ ${text}`);
         }, "Figma images listing");
         const imageData = await response.json();
         const images = imageData.images;
-        const fullAssetsDir = assetsDir.startsWith("/") ? assetsDir : join5(process.cwd(), assetsDir);
+        const fullAssetsDir = assetsDir.startsWith("/") ? assetsDir : join6(process.cwd(), assetsDir);
         if (!existsSync2(fullAssetsDir)) {
           await mkdir3(fullAssetsDir, { recursive: true });
         }
@@ -552,7 +549,7 @@ ${text}`);
             const safeName = node.name.replace(/[^a-z0-9]/gi, "_").toLowerCase().substring(0, 50);
             const extension = "png";
             const filename = `${safeName}_${node.id.substring(0, 8)}.${extension}`;
-            const filePath = join5(fullAssetsDir, filename);
+            const filePath = join6(fullAssetsDir, filename);
             await writeFile3(filePath, Buffer.from(imageBuffer));
             downloadedAssets.push({
               nodeId: node.id,
@@ -593,7 +590,7 @@ __export(figma_screen_developer_exports, {
   compareCodeWithFigma: () => compareCodeWithFigma
 });
 import { readFile as readFile4, readdir as readdir3 } from "fs/promises";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { existsSync as existsSync3 } from "fs";
 async function checkCurrentCodeStatus(projectPath = process.cwd()) {
   const status = {
@@ -607,13 +604,13 @@ async function checkCurrentCodeStatus(projectPath = process.cwd()) {
   };
   try {
     const htmlFiles = ["index.html", "index.htm", "main.html"].filter(
-      (file) => existsSync3(join6(projectPath, file))
+      (file) => existsSync3(join7(projectPath, file))
     );
     if (htmlFiles.length > 0) {
       status.hasHTML = true;
       status.htmlFile = htmlFiles[0];
       try {
-        const htmlContent = await readFile4(join6(projectPath, htmlFiles[0]), "utf-8");
+        const htmlContent = await readFile4(join7(projectPath, htmlFiles[0]), "utf-8");
         const sectionMatches = htmlContent.match(/<(section|div|header|footer|main|article|aside)[^>]*(?:id|class)=["']([^"']+)["']/gi);
         if (sectionMatches) {
           status.sections = sectionMatches.map((match) => {
@@ -625,19 +622,19 @@ async function checkCurrentCodeStatus(projectPath = process.cwd()) {
       } catch (e) {
       }
     }
-    const stylesDir = join6(projectPath, "styles");
+    const stylesDir = join7(projectPath, "styles");
     if (existsSync3(stylesDir)) {
       try {
         const files = await readdir3(stylesDir);
         const cssFiles = files.filter((f) => f.endsWith(".css"));
         if (cssFiles.length > 0) {
           status.hasCSS = true;
-          status.cssFiles = cssFiles.map((f) => join6(stylesDir, f));
+          status.cssFiles = cssFiles.map((f) => join7(stylesDir, f));
         }
       } catch (e) {
       }
     }
-    const assetsDir = join6(projectPath, "assets", "images");
+    const assetsDir = join7(projectPath, "assets", "images");
     if (existsSync3(assetsDir)) {
       try {
         const files = await readdir3(assetsDir);
@@ -716,7 +713,7 @@ __export(memory_exports, {
   MemoryManager: () => MemoryManager
 });
 import { readFile as readFile5, writeFile as writeFile4, mkdir as mkdir4, access as access2, constants as constants2 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 var MemoryManager;
 var init_memory = __esm({
   "src/core/memory.ts"() {
@@ -736,13 +733,13 @@ var init_memory = __esm({
         const memoryPath = paths.memory(this.config.configPath);
         const subDirs = ["observations", "handoffs", "research"];
         for (const subDir of subDirs) {
-          const dirPath = join7(memoryPath, subDir);
+          const dirPath = join8(memoryPath, subDir);
           try {
             const { readdir: readdir7 } = await import("fs/promises");
             const files = await readdir7(dirPath);
             for (const file of files) {
               if (!file.endsWith(".md")) continue;
-              const content = await readFile5(join7(dirPath, file), "utf-8");
+              const content = await readFile5(join8(dirPath, file), "utf-8");
               const summary = this.extractSummary(content);
               memories.push({
                 key: `${subDir}/${file.replace(".md", "")}`,
@@ -766,11 +763,11 @@ var init_memory = __esm({
         const memoryPath = paths.memory(this.config.configPath);
         let filePath;
         if (key.includes("/")) {
-          filePath = join7(memoryPath, `${key}.md`);
+          filePath = join8(memoryPath, `${key}.md`);
         } else {
           const subDirs = ["observations", "handoffs", "research", "_templates"];
           for (const subDir of subDirs) {
-            const testPath = join7(memoryPath, subDir, `${key}.md`);
+            const testPath = join8(memoryPath, subDir, `${key}.md`);
             try {
               await access2(testPath, constants2.R_OK);
               filePath = testPath;
@@ -779,7 +776,7 @@ var init_memory = __esm({
               continue;
             }
           }
-          filePath = filePath || join7(memoryPath, `${key}.md`);
+          filePath = filePath || join8(memoryPath, `${key}.md`);
         }
         try {
           return await readFile5(filePath, "utf-8");
@@ -795,10 +792,10 @@ var init_memory = __esm({
         const type = options?.type || "custom";
         let filePath;
         if (key.includes("/")) {
-          filePath = join7(memoryPath, `${key}.md`);
+          filePath = join8(memoryPath, `${key}.md`);
         } else {
           const subDir = type === "observation" ? "observations" : type === "handoff" ? "handoffs" : type === "research" ? "research" : "";
-          filePath = join7(memoryPath, subDir, `${key}.md`);
+          filePath = join8(memoryPath, subDir, `${key}.md`);
         }
         const { dirname: dirname2 } = await import("path");
         await mkdir4(dirname2(filePath), { recursive: true });
@@ -932,7 +929,7 @@ __export(tool_config_exports, {
   ToolConfigManager: () => ToolConfigManager
 });
 import { readFile as readFile7, writeFile as writeFile8, mkdir as mkdir8, access as access4, constants as constants4 } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join13 } from "path";
 import { z as z3 } from "zod";
 var ToolConfigSchema, REGISTERED_TOOLS, ToolConfigManager;
 var init_tool_config = __esm({
@@ -960,7 +957,7 @@ var init_tool_config = __esm({
       toolsConfigPath;
       constructor(config) {
         this.config = config;
-        this.toolsConfigPath = join11(this.config.configPath, "config", "tools.json");
+        this.toolsConfigPath = join13(this.config.configPath, "config", "tools.json");
       }
       /**
        * Get all registered tools with their current status
@@ -1054,7 +1051,7 @@ var init_tool_config = __esm({
        * Save configurations
        */
       async saveConfigs(configs) {
-        const configDir = join11(this.config.configPath, "config");
+        const configDir = join13(this.config.configPath, "config");
         await mkdir8(configDir, { recursive: true });
         await writeFile8(this.toolsConfigPath, JSON.stringify(configs, null, 2));
       }
@@ -1103,8 +1100,8 @@ var init_figma_oauth = __esm({
         console.log('3. Give it a name (e.g., "AIKit")');
         console.log("4. Copy the token (you won't see it again!)");
         console.log("5. Paste it here when prompted\n");
-        const { default: inquirer } = await import("inquirer");
-        const { token } = await inquirer.prompt([
+        const { default: inquirer2 } = await import("inquirer");
+        const { token } = await inquirer2.prompt([
           {
             type: "password",
             name: "token",
@@ -1134,14 +1131,14 @@ var init_figma_oauth = __esm({
        * Alternative: Manual token input
        */
       async authenticateManual() {
-        const { default: inquirer } = await import("inquirer");
+        const { default: inquirer2 } = await import("inquirer");
         console.log("\n\u{1F510} Figma Authentication (Manual)\n");
         console.log("To get your Figma Personal Access Token:");
         console.log("1. Visit: https://www.figma.com/developers/api#access-tokens");
         console.log('2. Scroll to "Personal access tokens"');
         console.log('3. Click "Create new token"');
         console.log("4. Copy the token and paste it below\n");
-        const { token } = await inquirer.prompt([
+        const { token } = await inquirer2.prompt([
           {
             type: "password",
             name: "token",
@@ -1195,6 +1192,7 @@ var init_figma_oauth = __esm({
 init_esm_shims();
 import { Command } from "commander";
 import chalk2 from "chalk";
+import inquirer from "inquirer";
 
 // src/index.ts
 init_esm_shims();
@@ -1203,8 +1201,28 @@ init_esm_shims();
 init_esm_shims();
 init_paths();
 import { readFile, access, constants } from "fs/promises";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { z } from "zod";
+
+// src/utils/version.ts
+init_esm_shims();
+import { readFileSync } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname, join as join2 } from "path";
+function getVersion() {
+  try {
+    const __filename2 = fileURLToPath2(import.meta.url);
+    const __dirname2 = dirname(__filename2);
+    const packageJsonPath = join2(__dirname2, "..", "package.json");
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    return packageJson.version;
+  } catch (error) {
+    console.warn("Warning: Could not read version from package.json, using fallback");
+    return "0.0.0";
+  }
+}
+
+// src/core/config.ts
 var ConfigSchema = z.object({
   version: z.string(),
   skills: z.object({
@@ -1296,23 +1314,23 @@ async function loadConfig(projectPath) {
   let configPath;
   let configData = {};
   try {
-    await access(join2(globalConfigPath, "aikit.json"), constants.R_OK);
-    const globalContent = await readFile(join2(globalConfigPath, "aikit.json"), "utf-8");
+    await access(join3(globalConfigPath, "aikit.json"), constants.R_OK);
+    const globalContent = await readFile(join3(globalConfigPath, "aikit.json"), "utf-8");
     configData = JSON.parse(globalContent);
     configPath = globalConfigPath;
   } catch {
     configPath = projectConfigPath;
   }
   try {
-    await access(join2(projectConfigPath, "aikit.json"), constants.R_OK);
-    const projectContent = await readFile(join2(projectConfigPath, "aikit.json"), "utf-8");
+    await access(join3(projectConfigPath, "aikit.json"), constants.R_OK);
+    const projectContent = await readFile(join3(projectConfigPath, "aikit.json"), "utf-8");
     const projectData = JSON.parse(projectContent);
     configData = deepMerge(configData, projectData);
     configPath = projectConfigPath;
   } catch {
   }
   if (!configData.version) {
-    configData.version = "0.1.0";
+    configData.version = getVersion();
   }
   const parsed = ConfigSchema.parse(configData);
   return new Config({
@@ -1341,8 +1359,9 @@ function deepMerge(base, override) {
 // src/core/skills.ts
 init_esm_shims();
 init_paths();
+init_logger();
 import { readFile as readFile2, readdir, writeFile, mkdir } from "fs/promises";
-import { join as join3, basename, extname } from "path";
+import { join as join4, basename, extname } from "path";
 import matter from "gray-matter";
 var SkillEngine = class {
   config;
@@ -1413,7 +1432,7 @@ var SkillEngine = class {
     const skillsDir = paths.skills(configPath);
     await mkdir(skillsDir, { recursive: true });
     const fileName = `${name.replace(/\s+/g, "-").toLowerCase()}.md`;
-    const filePath = join3(skillsDir, fileName);
+    const filePath = join4(skillsDir, fileName);
     const frontmatter = {
       name,
       description: options?.description || `Use when you need to ${name}`,
@@ -1474,12 +1493,22 @@ Describe what this skill does.
     if (globalSkillsPath === projectSkillsPath) {
       return { count: 0, synced: [] };
     }
-    const globalSkills = await this.loadSkillsFromDir(globalSkillsPath);
+    let globalSkills = [];
+    try {
+      globalSkills = await this.loadSkillsFromDir(globalSkillsPath);
+    } catch (error) {
+      logger.warn("Global skills directory not found. Skipping sync.");
+      return { count: 0, synced: [] };
+    }
+    if (globalSkills.length === 0) {
+      logger.info("No global skills to sync.");
+      return { count: 0, synced: [] };
+    }
     await mkdir(projectSkillsPath, { recursive: true });
     const synced = [];
     for (const skill of globalSkills) {
       const fileName = `${skill.name.replace(/\s+/g, "-").toLowerCase()}.md`;
-      const destPath = join3(projectSkillsPath, fileName);
+      const destPath = join4(projectSkillsPath, fileName);
       const srcContent = await readFile2(skill.filePath, "utf-8");
       await writeFile(destPath, srcContent);
       synced.push(skill.name);
@@ -1513,7 +1542,7 @@ ${skill.content}
     const skills = [];
     for (const file of files) {
       if (extname(file) !== ".md") continue;
-      const filePath = join3(dir, file);
+      const filePath = join4(dir, file);
       const content = await readFile2(filePath, "utf-8");
       const { data, content: body } = matter(content);
       const frontmatter = data;
@@ -1853,7 +1882,7 @@ ${agent.delegatesTo.map((a) => `- @${a}`).join("\n")}` : ""}
 init_esm_shims();
 init_paths();
 import { readFile as readFile3, readdir as readdir2, writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
-import { join as join4, basename as basename2, extname as extname2 } from "path";
+import { join as join5, basename as basename2, extname as extname2 } from "path";
 import matter2 from "gray-matter";
 var DEFAULT_COMMANDS = [
   // Core Workflow Commands (Beads integration)
@@ -2545,10 +2574,10 @@ var CommandRunner = class {
   async createCommand(name, options) {
     const configPath = options?.global ? paths.globalConfig() : this.config.configPath;
     const category = options?.category || "utility";
-    const commandsDir = join4(paths.commands(configPath), category);
+    const commandsDir = join5(paths.commands(configPath), category);
     await mkdir2(commandsDir, { recursive: true });
     const fileName = `${name}.md`;
-    const filePath = join4(commandsDir, fileName);
+    const filePath = join5(commandsDir, fileName);
     const frontmatter = {
       name,
       description: options?.description || `Custom command: ${name}`,
@@ -2607,7 +2636,7 @@ ${command.content}
       try {
         const entries = await readdir2(currentDir, { withFileTypes: true });
         for (const entry of entries) {
-          const fullPath = join4(currentDir, entry.name);
+          const fullPath = join5(currentDir, entry.name);
           if (entry.isDirectory()) {
             await processDir(fullPath, entry.name);
           } else if (extname2(entry.name) === ".md") {
@@ -2640,7 +2669,7 @@ init_esm_shims();
 init_paths();
 init_logger();
 import { readdir as readdir4, writeFile as writeFile5, mkdir as mkdir5 } from "fs/promises";
-import { join as join8, extname as extname3 } from "path";
+import { join as join9, extname as extname3 } from "path";
 import { z as z2 } from "zod";
 var ToolArgSchema = z2.object({
   type: z2.enum(["string", "number", "boolean", "array", "object"]),
@@ -3102,7 +3131,7 @@ ${tokens.screens?.map((s, i) => `${i + 1}. ${s.name} (ID: ${s.id})`).join("\n")
           try {
             const fileData = await client.getFileData(figmaUrl);
             const projectPath = process.cwd();
-            const assetsDir = join8(projectPath, "assets", "images");
+            const assetsDir = join9(projectPath, "assets", "images");
             const assets = await client.downloadAssets(fileKey, fileData.document, assetsDir, selectedScreen.id);
             downloadedAssets = assets || [];
             logger.info(`Downloaded ${downloadedAssets.length} assets for screen ${selectedScreen.name}`);
@@ -3348,7 +3377,7 @@ var ToolRegistry = class {
     const toolsDir = paths.tools(configPath);
     await mkdir5(toolsDir, { recursive: true });
     const fileName = `${name}.ts`;
-    const filePath = join8(toolsDir, fileName);
+    const filePath = join9(toolsDir, fileName);
     const argsSchema = Object.entries(options.args).map(([argName, arg]) => `    ${argName}: {
       type: '${arg.type}',
       description: '${arg.description}',
@@ -3402,7 +3431,7 @@ ${argsDesc}
     }
     for (const file of files) {
       if (extname3(file) !== ".ts" && extname3(file) !== ".js") continue;
-      const filePath = join8(dir, file);
+      const filePath = join9(dir, file);
       try {
         const toolModule = await import(`file://${filePath}`);
         const tool = toolModule.default;
@@ -3422,7 +3451,7 @@ init_esm_shims();
 init_paths();
 init_logger();
 import { readdir as readdir5, writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
-import { join as join9, basename as basename3, extname as extname4 } from "path";
+import { join as join10, basename as basename3, extname as extname4 } from "path";
 var PluginSystem = class {
   config;
   plugins = /* @__PURE__ */ new Map();
@@ -3522,7 +3551,7 @@ var PluginSystem = class {
     const pluginsDir = paths.plugins(configPath);
     await mkdir6(pluginsDir, { recursive: true });
     const fileName = `${name}.ts`;
-    const filePath = join9(pluginsDir, fileName);
+    const filePath = join10(pluginsDir, fileName);
     const content = `import { Plugin } from 'aikit';
 
 /**
@@ -3612,7 +3641,7 @@ export default ${toPascalCase(name)}Plugin;
     }
     for (const file of files) {
       if (extname4(file) !== ".ts" && extname4(file) !== ".js") continue;
-      const filePath = join9(dir, file);
+      const filePath = join10(dir, file);
       const name = basename3(file, extname4(file));
       this.plugins.set(name, {
         name,
@@ -3719,7 +3748,7 @@ init_esm_shims();
 init_paths();
 init_logger();
 import { readFile as readFile6, writeFile as writeFile7, readdir as readdir6, access as access3, constants as constants3, mkdir as mkdir7 } from "fs/promises";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import { exec } from "child_process";
 import { promisify } from "util";
 var execAsync = promisify(exec);
@@ -3764,7 +3793,19 @@ var BeadsIntegration = class {
     }
   }
   /**
-   * Initialize Beads in project
+   * Install Beads CLI globally
+   */
+  async install() {
+    try {
+      await execAsync("npm install -g beads");
+      return true;
+    } catch (error) {
+      logger.error("Failed to install Beads CLI:", error);
+      return false;
+    }
+  }
+  /**
+   * Initialize Beads in project using bd CLI
    */
   async init() {
     try {
@@ -3776,6 +3817,44 @@ var BeadsIntegration = class {
       return false;
     }
   }
+  /**
+   * Initialize local .beads directory (works without global beads CLI)
+   */
+  async initLocal() {
+    try {
+      const beadsDir = paths.beadsDir(this.projectPath);
+      await mkdir7(beadsDir, { recursive: true });
+      const readmeContent = `# Beads - Task Tracking
+
+This directory contains task beads for tracking work items.
+
+## How it works
+- Each file is a task bead (bead-001.md, bead-002.md, etc.)
+- Status: todo, in-progress, completed, blocked
+- Use \`/create\` command to create new tasks
+- Use \`/finish\` command to complete tasks with quality gates
+
+## Beads CLI
+For full functionality, install beads globally:
+\`\`\`bash
+npm install -g beads
+bd init
+\`\`\`
+
+## Available Commands
+- \`bd ready\` - Show available work
+- \`bd show <id>\` - View task details
+- \`bd update <id> --status in_progress\` - Update task status
+- \`bd close <id>\` - Complete task
+- \`bd sync\` - Sync with git
+`;
+      await writeFile7(join11(beadsDir, "README.md"), readmeContent);
+      return true;
+    } catch (error) {
+      logger.error("Failed to initialize .beads directory:", error);
+      return false;
+    }
+  }
   /**
    * Get current status
    */
@@ -3812,7 +3891,7 @@ var BeadsIntegration = class {
       const files = await readdir6(beadsDir);
       for (const file of files) {
         if (!file.match(/^bead-\d+\.md$/)) continue;
-        const content = await readFile6(join10(beadsDir, file), "utf-8");
+        const content = await readFile6(join11(beadsDir, file), "utf-8");
         const bead = this.parseBeadFile(file, content);
         if (bead) beads.push(bead);
       }
@@ -3827,7 +3906,7 @@ var BeadsIntegration = class {
     const beadsDir = paths.beadsDir(this.projectPath);
     const fileName = id.endsWith(".md") ? id : `${id}.md`;
     try {
-      const content = await readFile6(join10(beadsDir, fileName), "utf-8");
+      const content = await readFile6(join11(beadsDir, fileName), "utf-8");
       return this.parseBeadFile(fileName, content);
     } catch {
       return null;
@@ -3871,7 +3950,7 @@ ${description}
 ## Progress
 
 `;
-    await writeFile7(join10(beadsDir, `${id}.md`), content);
+    await writeFile7(join11(beadsDir, `${id}.md`), content);
     return {
       id,
       title,
@@ -3888,7 +3967,7 @@ ${description}
   async updateBeadStatus(id, status) {
     const beadsDir = paths.beadsDir(this.projectPath);
     const fileName = id.endsWith(".md") ? id : `${id}.md`;
-    const filePath = join10(beadsDir, fileName);
+    const filePath = join11(beadsDir, fileName);
     try {
       let content = await readFile6(filePath, "utf-8");
       content = content.replace(
@@ -3911,7 +3990,7 @@ ${description}
   async addNote(id, note) {
     const beadsDir = paths.beadsDir(this.projectPath);
     const fileName = id.endsWith(".md") ? id : `${id}.md`;
-    const filePath = join10(beadsDir, fileName);
+    const filePath = join11(beadsDir, fileName);
     try {
       let content = await readFile6(filePath, "utf-8");
       const notesMatch = content.match(/## Notes\n([\s\S]*?)(?=\n##|$)/);
@@ -4020,14 +4099,125 @@ init_logger();
 // src/index.ts
 init_logger();
 init_paths();
-var VERSION = "0.1.4";
 
 // src/cli.ts
 init_memory();
+
+// src/utils/cli-detector.ts
+init_esm_shims();
+import { execSync } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import { join as join12 } from "path";
+import { homedir as homedir2 } from "os";
+var CliDetector = class {
+  /**
+   * Check if OpenCode is installed
+   */
+  static async checkOpenCode() {
+    try {
+      const opencodePath = process.platform === "win32" ? process.env.APPDATA || join12(homedir2(), "AppData", "Roaming") : join12(homedir2(), ".config");
+      const opencodeConfig = join12(opencodePath, "opencode", "opencode.json");
+      const installed = existsSync4(opencodeConfig);
+      let version;
+      if (installed) {
+        try {
+          execSync("opencode --version", { stdio: "ignore" });
+          version = "installed";
+        } catch {
+        }
+      }
+      return {
+        name: "opencode" /* OPENCODE */,
+        displayName: "OpenCode",
+        detected: true,
+        installed,
+        version,
+        configPath: opencodeConfig
+      };
+    } catch {
+      return {
+        name: "opencode" /* OPENCODE */,
+        displayName: "OpenCode",
+        detected: false,
+        installed: false
+      };
+    }
+  }
+  /**
+   * Check if Claude CLI is installed
+   */
+  static async checkClaude() {
+    try {
+      execSync("claude --version", { stdio: "ignore" });
+      return {
+        name: "claude" /* CLAUDE */,
+        displayName: "Claude CLI",
+        detected: true,
+        installed: true,
+        version: "installed"
+      };
+    } catch {
+      return {
+        name: "claude" /* CLAUDE */,
+        displayName: "Claude CLI",
+        detected: true,
+        installed: false
+      };
+    }
+  }
+  /**
+   * Check if GitHub CLI is installed
+   */
+  static async checkGitHub() {
+    try {
+      const output = execSync("gh --version", { stdio: "pipe", encoding: "utf-8" });
+      const match = output.match(/gh version ([\d.]+)/);
+      const version = match?.[1];
+      return {
+        name: "github" /* GITHUB */,
+        displayName: "GitHub CLI",
+        detected: true,
+        installed: true,
+        version
+      };
+    } catch {
+      return {
+        name: "github" /* GITHUB */,
+        displayName: "GitHub CLI",
+        detected: true,
+        installed: false
+      };
+    }
+  }
+  /**
+   * Check all supported CLIs
+   */
+  static async checkAll() {
+    const results = [];
+    results.push(await this.checkOpenCode());
+    results.push(await this.checkClaude());
+    results.push(await this.checkGitHub());
+    return results;
+  }
+  /**
+   * Filter tools by installation status
+   */
+  static filterInstalled(tools) {
+    return tools.filter((t) => !t.installed && t.detected);
+  }
+  /**
+   * Filter tools that can be installed
+   */
+  static filterInstallable(tools) {
+    return tools.filter((t) => t.detected && !t.installed);
+  }
+};
+
+// src/cli.ts
 init_logger();
 init_paths();
 var program = new Command();
-program.name("aikit").description("Open-source AI coding agent toolkit for OpenCode").version(VERSION);
+program.name("aikit").description("Open-source AI coding agent toolkit for OpenCode").version(getVersion());
 program.command("init").description("Initialize AIKit configuration").option("-g, --global", "Initialize global configuration").option("-p, --project", "Initialize project-level configuration").action(async (options) => {
   const configDir = options.global ? paths.globalConfig() : paths.projectConfig();
   console.log(chalk2.bold("\n\u{1F680} AIKit Setup\n"));
@@ -4042,14 +4232,54 @@ program.command("init").description("Initialize AIKit configuration").option("-g
       if (result.count > 0) {
         logger.success(`\u2713 Synced ${result.count} skills`);
       }
+      console.log(chalk2.bold("\n\u{1F50D} Checking CLI tools...\n"));
+      const cliTools = await CliDetector.checkAll();
+      const installableTools = CliDetector.filterInstallable(cliTools);
+      for (const tool of cliTools) {
+        const status = tool.installed ? chalk2.green("\u2713 Installed") : chalk2.yellow("\u2717 Not installed");
+        const version = tool.version ? chalk2.gray(` (${tool.version})`) : "";
+        console.log(`  ${status} ${chalk2.cyan(tool.displayName)}${version}`);
+      }
+      if (installableTools.length > 0) {
+        console.log();
+        const { installTools } = await inquirer.prompt([
+          {
+            type: "checkbox",
+            name: "installTools",
+            message: "Select CLI tools to install (press Enter to skip):",
+            choices: installableTools.map((tool) => ({
+              name: tool.name,
+              value: tool,
+              checked: true
+              // Default to install all
+            }))
+          }
+        ]);
+        if (installTools.length > 0) {
+          console.log();
+          logger.info(`Installing ${installTools.length} CLI tool(s)...`);
+          for (const tool of installTools) {
+            await installCliTool(tool);
+          }
+          console.log();
+          logger.success("\u2713 CLI tools installed");
+        } else {
+          console.log();
+          logger.info("Skipping CLI tool installation");
+        }
+      } else {
+        console.log();
+        logger.success("\u2713 All CLI tools already installed");
+      }
       const beads = new BeadsIntegration();
       const beadsStatus = await beads.getStatus();
-      if (!beadsStatus.installed) {
-        logger.warn("Beads not installed. Please install it manually with: npm install -g beads");
-      } else if (!beadsStatus.initialized) {
-        logger.info("Initializing beads...");
-        await beads.init();
-        logger.success("\u2713 Beads initialized");
+      if (!beadsStatus.initialized) {
+        logger.info("Initializing .beads directory...");
+        await beads.initLocal();
+        logger.success("\u2713 .beads directory created");
+        if (!beadsStatus.installed) {
+          logger.info("Tip: Install Beads CLI globally for full functionality: npm install -g beads");
+        }
       } else {
         logger.info("Beads already initialized");
       }
@@ -4372,7 +4602,7 @@ beadsCmd.command("status").description("Show current Beads status").action(async
 });
 program.command("status").description("Show AIKit status").action(async () => {
   console.log(chalk2.bold(`
-\u{1F680} AIKit v${VERSION}
+\u{1F680} AIKit v${getVersion}
 `));
   try {
     const config = await loadConfig();
@@ -4399,7 +4629,7 @@ program.command("status").description("Show AIKit status").action(async () => {
 });
 async function initializeConfig(configDir, _isGlobal) {
   const { mkdir: mkdir9, writeFile: writeFile9 } = await import("fs/promises");
-  const { join: join12 } = await import("path");
+  const { join: join14 } = await import("path");
   const dirs = [
     "",
     "skills",
@@ -4418,10 +4648,10 @@ async function initializeConfig(configDir, _isGlobal) {
     "memory/research"
   ];
   for (const dir of dirs) {
-    await mkdir9(join12(configDir, dir), { recursive: true });
+    await mkdir9(join14(configDir, dir), { recursive: true });
   }
   const defaultConfig = {
-    version: VERSION,
+    version: getVersion,
     skills: { enabled: true },
     agents: { enabled: true, default: "build" },
     commands: { enabled: true },
@@ -4432,7 +4662,7 @@ async function initializeConfig(configDir, _isGlobal) {
     antiHallucination: { enabled: true }
   };
   await writeFile9(
-    join12(configDir, "aikit.json"),
+    join14(configDir, "aikit.json"),
     JSON.stringify(defaultConfig, null, 2)
   );
   const agentsMd = `# AIKit Agent Rules
@@ -4455,26 +4685,26 @@ async function initializeConfig(configDir, _isGlobal) {
 ## Project-Specific Rules
 Add your project-specific rules here.
 `;
-  await writeFile9(join12(configDir, "AGENTS.md"), agentsMd);
+  await writeFile9(join14(configDir, "AGENTS.md"), agentsMd);
 }
 async function configureMcpServer(projectPath) {
   const { mkdir: mkdir9, writeFile: writeFile9, readFile: readFile8 } = await import("fs/promises");
-  const { join: join12 } = await import("path");
-  const { existsSync: existsSync4 } = await import("fs");
-  const { homedir: homedir2 } = await import("os");
-  const { fileURLToPath: fileURLToPath2 } = await import("url");
+  const { join: join14 } = await import("path");
+  const { existsSync: existsSync5 } = await import("fs");
+  const { homedir: homedir3 } = await import("os");
+  const { fileURLToPath: fileURLToPath3 } = await import("url");
   const { dirname: dirname2 } = await import("path");
-  const currentFile = fileURLToPath2(import.meta.url);
+  const currentFile = fileURLToPath3(import.meta.url);
   const currentDir = dirname2(currentFile);
-  const aikitPath = join12(currentDir, "..");
-  const mcpServerPath = join12(aikitPath, "dist", "mcp-server.js");
+  const aikitPath = join14(currentDir, "..");
+  const mcpServerPath = join14(aikitPath, "dist", "mcp-server.js");
   const configLocations = [
     // Global config (most common)
-    join12(homedir2(), ".config", "opencode", "opencode.json"),
+    join14(homedir3(), ".config", "opencode", "opencode.json"),
     // Project-level config
-    join12(projectPath, ".opencode", "opencode.json"),
+    join14(projectPath, ".opencode", "opencode.json"),
     // Alternative global location
-    join12(homedir2(), ".opencode", "opencode.json")
+    join14(homedir3(), ".opencode", "opencode.json")
   ];
   const mcpServerConfig = {
     type: "local",
@@ -4483,10 +4713,10 @@ async function configureMcpServer(projectPath) {
   };
   for (const configPath of configLocations) {
     try {
-      const configDir = join12(configPath, "..");
+      const configDir = join14(configPath, "..");
       await mkdir9(configDir, { recursive: true });
       let config = {};
-      if (existsSync4(configPath)) {
+      if (existsSync5(configPath)) {
         try {
           const existing = await readFile8(configPath, "utf-8");
           config = JSON.parse(existing);
@@ -4507,8 +4737,8 @@ async function configureMcpServer(projectPath) {
       continue;
     }
   }
-  const instructionsPath = join12(projectPath, ".opencode", "MCP_SETUP.md");
-  await mkdir9(join12(projectPath, ".opencode"), { recursive: true });
+  const instructionsPath = join14(projectPath, ".opencode", "MCP_SETUP.md");
+  await mkdir9(join14(projectPath, ".opencode"), { recursive: true });
   await writeFile9(instructionsPath, `# AIKit MCP Server Configuration
 
 ## Automatic Setup Failed
@@ -4548,15 +4778,38 @@ After restarting OpenCode, check:
   logger.warn(`
 \u26A0\uFE0F  Could not auto-configure MCP server. See: ${instructionsPath}`);
 }
+async function installCliTool(tool) {
+  try {
+    logger.info(`Installing ${tool.displayName}...`);
+    switch (tool.name) {
+      case "opencode" /* OPENCODE */:
+        await installToOpenCode(paths.opencodeConfig());
+        break;
+      case "claude" /* CLAUDE */:
+        const { execSync: execSync2 } = await import("child_process");
+        execSync2("npm install -g @anthropic-ai/claude-code", { stdio: "inherit" });
+        break;
+      case "github" /* GITHUB */:
+        const { execSync: execGh } = await import("child_process");
+        execGh("npm install -g gh", { stdio: "inherit" });
+        break;
+    }
+    logger.success(`\u2713 ${tool.displayName} installed`);
+    return true;
+  } catch (error) {
+    logger.error(`Failed to install ${tool.displayName}:`, error);
+    return false;
+  }
+}
 async function installToOpenCode(_opencodePath) {
   const { mkdir: mkdir9, writeFile: writeFile9, access: access5 } = await import("fs/promises");
-  const { join: join12 } = await import("path");
+  const { join: join14 } = await import("path");
   const projectPath = process.cwd();
-  const opencodeCommandDir = join12(projectPath, ".opencode", "command");
-  const aikitDir = join12(projectPath, ".aikit");
-  const opencodeAgentDir = join12(paths.opencodeConfig(), "agent");
+  const opencodeCommandDir = join14(projectPath, ".opencode", "command");
+  const aikitDir = join14(projectPath, ".aikit");
+  const opencodeAgentDir = join14(paths.opencodeConfig(), "agent");
   await mkdir9(opencodeCommandDir, { recursive: true });
-  await mkdir9(join12(aikitDir, "skills"), { recursive: true });
+  await mkdir9(join14(aikitDir, "skills"), { recursive: true });
   await mkdir9(opencodeAgentDir, { recursive: true });
   const agentFiles = {
     agent: `---
@@ -4629,7 +4882,7 @@ tools:
 Use to interpret visual assets (components, layout, colors, typography) and translate to tasks.`
   };
   for (const [name, content] of Object.entries(agentFiles)) {
-    const filePath = join12(opencodeAgentDir, `${name}.md`);
+    const filePath = join14(opencodeAgentDir, `${name}.md`);
     try {
       await access5(filePath);
     } catch {
@@ -4886,7 +5139,7 @@ ${cmd.content}
   }
   let count = 0;
   for (const [name, content] of Object.entries(opencodeCommands)) {
-    const filePath = join12(opencodeCommandDir, `${name}.md`);
+    const filePath = join14(opencodeCommandDir, `${name}.md`);
     await writeFile9(filePath, content.trim());
     logger.info(`  \u2713 Created /${name} command`);
     count++;