@orderful/droid 0.23.0 → 0.25.0

package/dist/bin/droid.js

@@ -18,6 +18,9 @@ import { join } from "path";
 import YAML from "yaml";
 
 // src/lib/types.ts
+function getAITag() {
+  return "@droid";
+}
 function getPlatformTools(config) {
   return config.platforms[config.platform]?.tools ?? {};
 }
@@ -176,7 +179,14 @@ function setAutoUpdateConfig(updates) {
 }
 
 // src/lib/skills.ts
-import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync4, writeFileSync as writeFileSync3, rmSync as rmSync2 } from "fs";
+import {
+  existsSync as existsSync5,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync5,
+  mkdirSync as mkdirSync4,
+  writeFileSync as writeFileSync3,
+  rmSync as rmSync2
+} from "fs";
 import { join as join7, dirname as dirname5, basename } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import YAML4 from "yaml";
@@ -517,7 +527,14 @@ function uninstallAgent(agentName) {
 }
 
 // src/lib/migrations.ts
-import { existsSync as existsSync4, appendFileSync, mkdirSync as mkdirSync3, renameSync, rmSync } from "fs";
+import {
+  existsSync as existsSync4,
+  appendFileSync,
+  mkdirSync as mkdirSync3,
+  renameSync,
+  rmSync,
+  readdirSync as readdirSync3
+} from "fs";
 import { join as join6, dirname as dirname4 } from "path";
 var MIGRATIONS_LOG_FILE = ".migrations.log";
 function getMigrationsLogPath() {
@@ -555,11 +572,54 @@ function createConfigDirMigration(skillName, version2) {
     }
   };
 }
+function createPlatformSyncMigration(version2) {
+  return {
+    version: version2,
+    description: "Sync installed tools from disk to config",
+    up: () => {
+      const config = loadConfig();
+      const bundledTools = getBundledTools();
+      let configChanged = false;
+      const originalPlatform = config.platform;
+      for (const platformKey of ["claude-code" /* ClaudeCode */, "opencode" /* OpenCode */]) {
+        const skillsPath = getSkillsPath(platformKey);
+        if (!existsSync4(skillsPath)) continue;
+        config.platform = platformKey;
+        const trackedTools = getPlatformTools(config);
+        const installedDirs = readdirSync3(skillsPath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+        for (const skillName of installedDirs) {
+          const normalizedName = skillName.replace(/^droid-/, "");
+          const isTracked = trackedTools[skillName] || trackedTools[`droid-${normalizedName}`] || trackedTools[normalizedName];
+          if (isTracked) continue;
+          const matchingTool = bundledTools.find(
+            (tool) => tool.includes.skills.some((s) => s.name === skillName)
+          );
+          if (matchingTool) {
+            trackedTools[skillName] = {
+              version: matchingTool.version,
+              installed_at: (/* @__PURE__ */ new Date()).toISOString()
+            };
+            configChanged = true;
+          }
+        }
+        if (configChanged) {
+          setPlatformTools(config, trackedTools);
+        }
+      }
+      config.platform = originalPlatform;
+      if (configChanged) {
+        saveConfig(config);
+      }
+    }
+  };
+}
 var TOOL_MIGRATIONS = {
   brain: [createConfigDirMigration("droid-brain", "0.2.3")],
   comments: [createConfigDirMigration("droid-comments", "0.2.6")],
   project: [createConfigDirMigration("droid-project", "0.1.5")],
-  coach: [createConfigDirMigration("droid-coach", "0.1.3")]
+  coach: [createConfigDirMigration("droid-coach", "0.1.3")],
+  // Global migration for the droid meta-tool
+  droid: [createPlatformSyncMigration("0.25.0")]
 };
 function getToolMigrations(toolName) {
   return TOOL_MIGRATIONS[toolName] ?? [];
@@ -594,8 +654,17 @@ function runMigrations(toolName, fromVersion, toVersion) {
       logMigration(toolName, fromVersion, migration.version, "OK");
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      logMigration(toolName, fromVersion, migration.version, "FAILED", errorMessage);
-      return { success: false, error: `Migration ${migration.version} failed: ${errorMessage}` };
+      logMigration(
+        toolName,
+        fromVersion,
+        migration.version,
+        "FAILED",
+        errorMessage
+      );
+      return {
+        success: false,
+        error: `Migration ${migration.version} failed: ${errorMessage}`
+      };
     }
   }
   setLastMigratedVersion(toolName, toVersion);
@@ -692,7 +761,7 @@ function findSkillPath(skillName) {
   if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return null;
   }
-  const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+  const toolDirs = readdirSync4(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   for (const toolName of toolDirs) {
     const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
     if (!existsSync5(skillsDir)) continue;
@@ -710,12 +779,12 @@ function getBundledSkills() {
   if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return [];
   }
-  const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+  const toolDirs = readdirSync4(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   const skills = [];
   for (const toolName of toolDirs) {
     const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
     if (!existsSync5(skillsDir)) continue;
-    const skillSubdirs = readdirSync3(skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+    const skillSubdirs = readdirSync4(skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     for (const skillName of skillSubdirs) {
       const manifest = loadSkillManifest(join7(skillsDir, skillName));
       if (manifest) {
@@ -758,10 +827,16 @@ function updateSkill(skillName) {
     return { success: false, message: `Skill '${skillName}' is not installed` };
   }
   if (!status.bundledVersion) {
-    return { success: false, message: `Skill '${skillName}' not found in bundled skills` };
+    return {
+      success: false,
+      message: `Skill '${skillName}' not found in bundled skills`
+    };
   }
   if (!status.hasUpdate) {
-    return { success: false, message: `Skill '${skillName}' is already at latest version (${status.installedVersion})` };
+    return {
+      success: false,
+      message: `Skill '${skillName}' is already at latest version (${status.installedVersion})`
+    };
   }
   const result = installSkill(skillName);
   if (result.success) {
@@ -781,7 +856,10 @@ function installSkill(skillName) {
   const { toolDir, skillDir } = skillPath;
   const manifest = loadSkillManifest(skillDir);
   if (!manifest) {
-    return { success: false, message: `Invalid skill manifest for '${skillName}'` };
+    return {
+      success: false,
+      message: `Invalid skill manifest for '${skillName}'`
+    };
   }
   if (manifest.dependencies) {
     for (const dep of manifest.dependencies) {
@@ -798,30 +876,41 @@ function installSkill(skillName) {
   const commandsPath = getCommandsInstallPath(config.platform);
   const tools = getPlatformTools(config);
   if (skillName.startsWith("droid-")) {
-    const oldSkillName = skillName.replace(/^droid-/, "");
-    const oldSkillDir = join7(skillsPath, oldSkillName);
+    const oldSkillName2 = skillName.replace(/^droid-/, "");
+    const oldSkillDir = join7(skillsPath, oldSkillName2);
     if (existsSync5(oldSkillDir)) {
       try {
         rmSync2(oldSkillDir, { recursive: true });
       } catch (error) {
-        console.warn(`Warning: Could not remove old skill directory ${oldSkillDir}: ${error}`);
+        console.warn(
+          `Warning: Could not remove old skill directory ${oldSkillDir}: ${error}`
+        );
       }
     }
-    if (tools[oldSkillName]) {
-      delete tools[oldSkillName];
+    if (tools[oldSkillName2]) {
+      delete tools[oldSkillName2];
       setPlatformTools(config, tools);
       saveConfig(config);
     }
   }
   const commandsSource = join7(toolDir, "commands");
   const agentsSource = join7(toolDir, "agents");
-  if (!tools[skillName]) {
+  const oldSkillName = skillName.startsWith("droid-") ? skillName.replace(/^droid-/, "") : null;
+  const isAlreadyInstalled = tools[skillName] || oldSkillName && tools[oldSkillName];
+  if (!isAlreadyInstalled) {
+    const toolName2 = basename(toolDir);
+    const normalizedToolName = toolName2.replace(/^droid-/, "");
     if (existsSync5(commandsSource)) {
-      const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
+      const commandFiles = readdirSync4(commandsSource).filter(
+        (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
+      );
       for (const file of commandFiles) {
         const targetCommandPath = join7(commandsPath, file);
         if (existsSync5(targetCommandPath)) {
           const commandName = file.replace(".md", "");
+          if (commandName === toolName2 || commandName === normalizedToolName) {
+            continue;
+          }
           return {
             success: false,
             message: `Cannot install: command /${commandName} already exists at ${targetCommandPath}`
@@ -830,8 +919,8 @@ function installSkill(skillName) {
       }
     }
     if (existsSync5(agentsSource)) {
-      const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
-      for (const agentName of agentDirs) {
+      const agentFiles = readdirSync4(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isFile() && dirent.name.endsWith(".md")).map((dirent) => dirent.name.replace(".md", ""));
+      for (const agentName of agentFiles) {
         if (isAgentInstalled(agentName)) {
           return {
             success: false,
@@ -859,7 +948,9 @@ function installSkill(skillName) {
     if (!existsSync5(targetReferencesDir)) {
       mkdirSync4(targetReferencesDir, { recursive: true });
     }
-    const referenceFiles = readdirSync3(referencesSource).filter((f) => f.endsWith(".md"));
+    const referenceFiles = readdirSync4(referencesSource).filter(
+      (f) => f.endsWith(".md")
+    );
     for (const file of referenceFiles) {
       const sourcePath = join7(referencesSource, file);
       const targetPath = join7(targetReferencesDir, file);
@@ -867,11 +958,29 @@ function installSkill(skillName) {
       writeFileSync3(targetPath, content);
     }
   }
+  const scriptsSource = join7(skillDir, "scripts");
+  if (existsSync5(scriptsSource)) {
+    const targetScriptsDir = join7(targetSkillDir, "scripts");
+    if (!existsSync5(targetScriptsDir)) {
+      mkdirSync4(targetScriptsDir, { recursive: true });
+    }
+    const scriptFiles = readdirSync4(scriptsSource).filter(
+      (f) => f.endsWith(".ts") || f.endsWith(".js") || f.endsWith(".py")
+    );
+    for (const file of scriptFiles) {
+      const sourcePath = join7(scriptsSource, file);
+      const targetPath = join7(targetScriptsDir, file);
+      const content = readFileSync5(sourcePath, "utf-8");
+      writeFileSync3(targetPath, content);
+    }
+  }
   if (existsSync5(commandsSource)) {
     if (!existsSync5(commandsPath)) {
       mkdirSync4(commandsPath, { recursive: true });
     }
-    const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
+    const commandFiles = readdirSync4(commandsSource).filter(
+      (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
+    );
     for (const file of commandFiles) {
       const sourcePath = join7(commandsSource, file);
       const targetPath = join7(commandsPath, file);
@@ -881,10 +990,10 @@ function installSkill(skillName) {
   }
   const installedAgents = [];
   if (existsSync5(agentsSource)) {
-    const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
-    for (const agentName of agentDirs) {
-      const agentDir = join7(agentsSource, agentName);
-      const result = installAgentFromPath(agentDir, agentName);
+    const agentFiles = readdirSync4(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isFile() && dirent.name.endsWith(".md")).map((dirent) => dirent.name.replace(".md", ""));
+    for (const agentName of agentFiles) {
+      const agentPath = join7(agentsSource, `${agentName}.md`);
+      const result = installAgentFromPath(agentPath, agentName);
       if (result.success) {
         installedAgents.push(agentName);
       }
@@ -905,9 +1014,14 @@ function installSkill(skillName) {
   const toolName = basename(toolDir);
   const migrationResult = runToolMigrations(toolName, manifest.version);
   if (!migrationResult.success) {
-    console.warn(`Warning: Migration failed for ${toolName}: ${migrationResult.error}`);
+    console.warn(
+      `Warning: Migration failed for ${toolName}: ${migrationResult.error}`
+    );
   }
-  return { success: true, message: `Installed ${skillName} v${manifest.version}` };
+  return {
+    success: true,
+    message: `Installed ${skillName} v${manifest.version}`
+  };
 }
 function uninstallSkill(skillName) {
   const config = loadConfig();
@@ -924,7 +1038,9 @@ function uninstallSkill(skillName) {
   const commandsPath = getCommandsInstallPath(config.platform);
   const commandsSource = skillPath ? join7(skillPath.toolDir, "commands") : null;
   if (commandsSource && existsSync5(commandsSource)) {
-    const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
+    const commandFiles = readdirSync4(commandsSource).filter(
+      (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
+    );
     for (const file of commandFiles) {
       const commandPath = join7(commandsPath, file);
       if (existsSync5(commandPath)) {
@@ -1140,17 +1256,17 @@ async function setupCommand() {
     console.log(chalk2.yellow("  You may need to manually configure your platform"));
   } else if (answers.platform === "claude-code" /* ClaudeCode */) {
     if (added.length > 0) {
-      console.log(chalk2.green(`\u2713 Added droid permissions to Claude Code settings`));
+      console.log(chalk2.green("\u2713 Added droid permissions to Claude Code settings"));
     } else if (alreadyPresent) {
-      console.log(chalk2.gray(`  Droid permissions already configured in Claude Code`));
+      console.log(chalk2.gray("  Droid permissions already configured in Claude Code"));
     }
   } else if (answers.platform === "opencode" /* OpenCode */) {
     if (added.length > 0) {
-      console.log(chalk2.green(`\u2713 Added opencode-skills plugin to OpenCode config`));
-      console.log(chalk2.gray(`  This enables Claude Code-style skills in OpenCode`));
-      console.log(chalk2.gray(`  Restart OpenCode to activate the plugin`));
+      console.log(chalk2.green("\u2713 Added opencode-skills plugin to OpenCode config"));
+      console.log(chalk2.gray("  This enables Claude Code-style skills in OpenCode"));
+      console.log(chalk2.gray("  Restart OpenCode to activate the plugin"));
     } else if (alreadyPresent) {
-      console.log(chalk2.gray(`  opencode-skills plugin already configured in OpenCode`));
+      console.log(chalk2.gray("  opencode-skills plugin already configured in OpenCode"));
     }
   }
   console.log(chalk2.gray("\nRun `droid skills` to browse and install skills."));
@@ -1159,8 +1275,23 @@ async function setupCommand() {
 // src/commands/config.ts
 import chalk3 from "chalk";
 import { execSync as execSync3 } from "child_process";
-async function configCommand(options) {
-  if (options.edit) {
+function getToolConfig(toolName) {
+  const globalConfig = loadConfig();
+  const overrides = loadSkillOverrides(toolName);
+  return {
+    user_mention: globalConfig.user_mention,
+    ai_mention: getAITag(),
+    ...overrides
+    // Tool handles its own defaults
+  };
+}
+async function configCommand(tool, options) {
+  if (tool) {
+    const toolConfig = getToolConfig(tool);
+    console.log(JSON.stringify(toolConfig, null, 2));
+    return;
+  }
+  if (options?.edit) {
     const configPath = getConfigPath();
     const editor = process.env.EDITOR || "vim";
     if (!configExists()) {
@@ -1175,7 +1306,7 @@ async function configCommand(options) {
     }
     return;
   }
-  if (options.get) {
+  if (options?.get) {
     const value = getConfigValue(options.get);
     if (value === void 0) {
       console.log(chalk3.yellow(`Config key '${options.get}' not found`));
@@ -1188,7 +1319,7 @@ async function configCommand(options) {
     }
     return;
   }
-  if (options.set) {
+  if (options?.set) {
     const match = options.set.match(/^([^=]+)=(.*)$/);
     if (!match) {
       console.error(chalk3.red("Invalid format. Use: --set key=value"));
@@ -1464,7 +1595,7 @@ async function installCommand(toolName) {
     }
     console.log(chalk6.gray("\nNext steps:"));
     console.log(chalk6.gray("  - Run your AI tool to start using it"));
-    console.log(chalk6.gray(`  - Reconfigure anytime with \`droid\` \u2192 Configure`));
+    console.log(chalk6.gray("  - Reconfigure anytime with `droid` \u2192 Configure"));
   } else {
     console.error(chalk6.red(`\u2717 ${result.message}`));
     process.exit(1);
@@ -2842,6 +2973,10 @@ function App() {
       }
     }
   });
+  useEffect(() => {
+    const droidVersion = getVersion();
+    runToolMigrations("droid", droidVersion);
+  }, []);
   useEffect(() => {
     const autoUpdateConfig = getAutoUpdateConfig();
     if (autoUpdateConfig.app && updateInfo.hasUpdate && view === "welcome" && !isUpdating) {
@@ -2890,142 +3025,149 @@ function App() {
   };
   const tools = getBundledTools();
   const skills = getBundledSkills();
-  useInput7((input, key) => {
-    if (message) setMessage(null);
-    if (input === "q") {
-      exit();
-      return;
-    }
-    if (view === "menu") {
-      if (key.leftArrow) {
-        const newIndex = Math.max(0, tabIndex - 1);
-        setTabIndex(newIndex);
-        setActiveTab(tabs[newIndex].id);
-        setSelectedIndex(0);
-        setScrollOffset(0);
-      }
-      if (key.rightArrow) {
-        const newIndex = Math.min(tabs.length - 1, tabIndex + 1);
-        setTabIndex(newIndex);
-        setActiveTab(tabs[newIndex].id);
-        setSelectedIndex(0);
-        setScrollOffset(0);
-      }
-      if (key.upArrow) {
-        setSelectedIndex((prev) => {
-          const newIndex = Math.max(0, prev - 1);
-          if (newIndex < scrollOffset) {
-            setScrollOffset(newIndex);
-          }
-          return newIndex;
-        });
-        setSelectedAction(0);
-      }
-      if (key.downArrow) {
-        const maxIndex = activeTab === "tools" ? tools.length - 1 : 0;
-        setSelectedIndex((prev) => {
-          const newIndex = Math.min(maxIndex, prev + 1);
-          if (newIndex >= scrollOffset + MAX_VISIBLE_ITEMS) {
-            setScrollOffset(newIndex - MAX_VISIBLE_ITEMS + 1);
-          }
-          return newIndex;
-        });
-        setSelectedAction(0);
+  useInput7(
+    (input, key) => {
+      if (message) setMessage(null);
+      if (input === "q") {
+        exit();
+        return;
       }
-      if (key.return) {
-        if (activeTab === "tools" && tools.length > 0) {
-          setView("detail");
-        } else if (activeTab === "settings") {
-          setView("detail");
+      if (view === "menu") {
+        if (key.leftArrow) {
+          const newIndex = Math.max(0, tabIndex - 1);
+          setTabIndex(newIndex);
+          setActiveTab(tabs[newIndex].id);
+          setSelectedIndex(0);
+          setScrollOffset(0);
         }
-      }
-    } else if (view === "detail") {
-      if (key.escape || key.backspace) {
-        setView("menu");
-        setSelectedAction(0);
-      }
-      if (activeTab === "settings") {
-        if (key.return) {
-          setIsEditingSettings(true);
-          setView("setup");
+        if (key.rightArrow) {
+          const newIndex = Math.min(tabs.length - 1, tabIndex + 1);
+          setTabIndex(newIndex);
+          setActiveTab(tabs[newIndex].id);
+          setSelectedIndex(0);
+          setScrollOffset(0);
         }
-      }
-      if (key.leftArrow && activeTab === "tools") {
-        setSelectedAction((prev) => Math.max(0, prev - 1));
-      }
-      if (key.rightArrow && activeTab === "tools") {
-        let maxActions = 0;
-        const tool = tools[selectedIndex];
-        const installed = tool ? isToolInstalled(tool.name) : false;
-        const hasUpdate = tool ? getToolUpdateStatus(tool.name).hasUpdate : false;
-        const isSystem = tool ? tool.system === true : false;
-        maxActions = installed ? hasUpdate ? isSystem ? 2 : 3 : isSystem ? 1 : 2 : 1;
-        setSelectedAction((prev) => Math.min(maxActions, prev + 1));
-      }
-      if (key.return && activeTab === "tools") {
-        const tool = tools[selectedIndex];
-        if (tool) {
-          const installed = isToolInstalled(tool.name);
-          const toolUpdateStatus = getToolUpdateStatus(tool.name);
-          const isSystemTool = tool.system === true;
-          const toolActions = installed ? [
-            { id: "explore" },
-            ...toolUpdateStatus.hasUpdate ? [{ id: "update" }] : [],
-            { id: "configure" },
-            ...!isSystemTool ? [{ id: "uninstall" }] : []
-          ] : [{ id: "explore" }, { id: "install" }];
-          const actionId = toolActions[selectedAction]?.id;
-          if (actionId === "explore") {
-            setView("explorer");
-          } else if (actionId === "update") {
-            const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
-            const result = updateSkill(primarySkill);
-            setMessage({
-              text: result.success ? `\u2713 Updated ${tool.name}` : `\u2717 ${result.message}`,
-              type: result.success ? "success" : "error"
-            });
-            if (result.success) {
-              setSelectedAction(0);
+        if (key.upArrow) {
+          setSelectedIndex((prev) => {
+            const newIndex = Math.max(0, prev - 1);
+            if (newIndex < scrollOffset) {
+              setScrollOffset(newIndex);
             }
-          } else if (actionId === "configure") {
-            setView("configure");
-          } else if (actionId === "uninstall") {
-            const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
-            const result = uninstallSkill(primarySkill);
-            setMessage({
-              text: result.success ? `\u2713 Uninstalled ${tool.name}` : `\u2717 ${result.message}`,
-              type: result.success ? "success" : "error"
-            });
-            if (result.success) {
-              setView("menu");
-              setSelectedAction(0);
+            return newIndex;
+          });
+          setSelectedAction(0);
+        }
+        if (key.downArrow) {
+          const maxIndex = activeTab === "tools" ? tools.length - 1 : 0;
+          setSelectedIndex((prev) => {
+            const newIndex = Math.min(maxIndex, prev + 1);
+            if (newIndex >= scrollOffset + MAX_VISIBLE_ITEMS) {
+              setScrollOffset(newIndex - MAX_VISIBLE_ITEMS + 1);
             }
-          } else if (actionId === "install") {
-            const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
-            const result = installSkill(primarySkill);
-            setMessage({
-              text: result.success ? `\u2713 Installed ${tool.name}` : `\u2717 ${result.message}`,
-              type: result.success ? "success" : "error"
-            });
-            if (result.success) {
-              const configSchema = tool.config_schema || {};
-              const hasRequiredConfig = Object.values(configSchema).some(
-                (option) => option.default === void 0
-              );
-              if (hasRequiredConfig) {
-                setView("configure");
-              } else {
+            return newIndex;
+          });
+          setSelectedAction(0);
+        }
+        if (key.return) {
+          if (activeTab === "tools" && tools.length > 0) {
+            setView("detail");
+          } else if (activeTab === "settings") {
+            setView("detail");
+          }
+        }
+      } else if (view === "detail") {
+        if (key.escape || key.backspace) {
+          setView("menu");
+          setSelectedAction(0);
+        }
+        if (activeTab === "settings") {
+          if (key.return) {
+            setIsEditingSettings(true);
+            setView("setup");
+          }
+        }
+        if (key.leftArrow && activeTab === "tools") {
+          setSelectedAction((prev) => Math.max(0, prev - 1));
+        }
+        if (key.rightArrow && activeTab === "tools") {
+          let maxActions = 0;
+          const tool = tools[selectedIndex];
+          const installed = tool ? isToolInstalled(tool.name) : false;
+          const hasUpdate = tool ? getToolUpdateStatus(tool.name).hasUpdate : false;
+          const isSystem = tool ? tool.system === true : false;
+          maxActions = installed ? hasUpdate ? isSystem ? 2 : 3 : isSystem ? 1 : 2 : 1;
+          setSelectedAction((prev) => Math.min(maxActions, prev + 1));
+        }
+        if (key.return && activeTab === "tools") {
+          const tool = tools[selectedIndex];
+          if (tool) {
+            const installed = isToolInstalled(tool.name);
+            const toolUpdateStatus = getToolUpdateStatus(tool.name);
+            const isSystemTool = tool.system === true;
+            const toolActions = installed ? [
+              { id: "explore" },
+              ...toolUpdateStatus.hasUpdate ? [{ id: "update" }] : [],
+              { id: "configure" },
+              ...!isSystemTool ? [{ id: "uninstall" }] : []
+            ] : [{ id: "explore" }, { id: "install" }];
+            const actionId = toolActions[selectedAction]?.id;
+            if (actionId === "explore") {
+              setView("explorer");
+            } else if (actionId === "update") {
+              const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = updateSkill(primarySkill);
+              setMessage({
+                text: result.success ? `\u2713 Updated ${tool.name}` : `\u2717 ${result.message}`,
+                type: result.success ? "success" : "error"
+              });
+              if (result.success) {
+                setSelectedAction(0);
+              }
+            } else if (actionId === "configure") {
+              setView("configure");
+            } else if (actionId === "uninstall") {
+              const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = uninstallSkill(primarySkill);
+              setMessage({
+                text: result.success ? `\u2713 Uninstalled ${tool.name}` : `\u2717 ${result.message}`,
+                type: result.success ? "success" : "error"
+              });
+              if (result.success) {
                 setView("menu");
                 setSelectedAction(0);
               }
+            } else if (actionId === "install") {
+              const primarySkill = tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = installSkill(primarySkill);
+              setMessage({
+                text: result.success ? `\u2713 Installed ${tool.name}` : `\u2717 ${result.message}`,
+                type: result.success ? "success" : "error"
+              });
+              if (result.success) {
+                const configSchema = tool.config_schema || {};
+                const hasRequiredConfig = Object.values(configSchema).some(
+                  (option) => option.default === void 0
+                );
+                if (hasRequiredConfig) {
+                  setView("configure");
+                } else {
+                  setView("menu");
+                  setSelectedAction(0);
+                }
+              }
             }
           }
         }
       }
+    },
+    {
+      isActive: view !== "welcome" && view !== "tool-updates" && view !== "setup" && view !== "configure" && view !== "explorer"
     }
-  }, { isActive: view !== "welcome" && view !== "tool-updates" && view !== "setup" && view !== "configure" && view !== "explorer" });
+  );
   const selectedTool = activeTab === "tools" ? tools[selectedIndex] ?? null : null;
-  const selectedSkillForConfig = selectedTool ? skills.find((s) => s.name === (selectedTool.includes.skills.find((sk) => sk.required)?.name || selectedTool.name)) : null;
+  const selectedSkillForConfig = selectedTool ? skills.find(
+    (s) => s.name === (selectedTool.includes.skills.find((sk) => sk.required)?.name || selectedTool.name)
+  ) : null;
   if (view === "welcome") {
     return /* @__PURE__ */ jsx13(
       WelcomeScreen,
@@ -3102,7 +3244,10 @@ function App() {
       {
         skill: selectedSkillForConfig,
         onComplete: () => {
-          setMessage({ text: `\u2713 Configuration saved for ${selectedTool?.name || selectedSkillForConfig.name}`, type: "success" });
+          setMessage({
+            text: `\u2713 Configuration saved for ${selectedTool?.name || selectedSkillForConfig.name}`,
+            type: "success"
+          });
           setView("detail");
         },
         onCancel: () => {
@@ -3163,18 +3308,26 @@ function App() {
             ] }),
             activeTab === "settings" && /* @__PURE__ */ jsx13(Box12, { paddingX: 1, children: /* @__PURE__ */ jsx13(Text13, { color: colors.textDim, children: "View and edit config" }) })
           ] }),
-          message && /* @__PURE__ */ jsx13(Box12, { paddingX: 1, marginTop: 1, children: /* @__PURE__ */ jsx13(Text13, { color: message.type === "success" ? colors.success : colors.error, children: message.text }) }),
+          message && /* @__PURE__ */ jsx13(Box12, { paddingX: 1, marginTop: 1, children: /* @__PURE__ */ jsx13(
+            Text13,
+            {
+              color: message.type === "success" ? colors.success : colors.error,
+              children: message.text
+            }
+          ) }),
           /* @__PURE__ */ jsx13(Box12, { paddingX: 1, marginTop: 1, children: /* @__PURE__ */ jsx13(Text13, { color: colors.textDim, children: view === "menu" ? "\u2190\u2192 \u2191\u2193 enter q" : "\u2190\u2192 enter esc q" }) })
         ]
       }
     ),
-    activeTab === "tools" && /* @__PURE__ */ jsx13(ToolDetails, { tool: selectedTool, isFocused: view === "detail", selectedAction }),
-    activeTab === "settings" && /* @__PURE__ */ jsx13(
-      SettingsDetails,
+    activeTab === "tools" && /* @__PURE__ */ jsx13(
+      ToolDetails,
       {
-        isFocused: view === "detail"
+        tool: selectedTool,
+        isFocused: view === "detail",
+        selectedAction
       }
-    )
+    ),
+    activeTab === "settings" && /* @__PURE__ */ jsx13(SettingsDetails, { isFocused: view === "detail" })
   ] });
 }
 async function tuiCommand() {
@@ -3189,16 +3342,77 @@ async function tuiCommand() {
   }
 }
 
+// src/commands/exec.ts
+import chalk9 from "chalk";
+import { spawn } from "child_process";
+import { existsSync as existsSync8 } from "fs";
+import { join as join10 } from "path";
+function getRuntime(toolPath) {
+  if (toolPath.endsWith(".ts") || toolPath.endsWith(".js")) {
+    return { cmd: "bun", args: ["run", toolPath] };
+  }
+  if (toolPath.endsWith(".py")) {
+    return { cmd: "python3", args: [toolPath] };
+  }
+  return null;
+}
+async function execCommand(tool, script, args) {
+  const config = loadConfig();
+  const skillsPath = getSkillsPath(config.platform);
+  const toolDir = join10(skillsPath, tool);
+  if (!existsSync8(toolDir)) {
+    console.error(chalk9.red(`Tool '${tool}' not found at ${toolDir}`));
+    process.exit(1);
+  }
+  const scriptsDir = join10(toolDir, "scripts");
+  if (!existsSync8(scriptsDir)) {
+    console.error(chalk9.red(`No scripts directory in tool '${tool}'`));
+    process.exit(1);
+  }
+  const extensions = [".ts", ".js", ".py"];
+  let scriptPath = null;
+  for (const ext of extensions) {
+    const candidate = join10(scriptsDir, script + ext);
+    if (existsSync8(candidate)) {
+      scriptPath = candidate;
+      break;
+    }
+  }
+  if (!scriptPath) {
+    console.error(chalk9.red(`Script '${script}' not found in ${scriptsDir}`));
+    console.error(chalk9.gray(`Looked for: ${extensions.map((e) => script + e).join(", ")}`));
+    process.exit(1);
+  }
+  const runtime = getRuntime(scriptPath);
+  if (!runtime) {
+    console.error(chalk9.red(`Unsupported script type: ${scriptPath}`));
+    process.exit(1);
+  }
+  const fullArgs = [...runtime.args, ...args];
+  const child = spawn(runtime.cmd, fullArgs, {
+    stdio: "inherit",
+    cwd: process.cwd()
+  });
+  child.on("error", (err) => {
+    console.error(chalk9.red(`Failed to execute tool: ${err.message}`));
+    process.exit(1);
+  });
+  child.on("close", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+
 // src/bin/droid.ts
 var version = getVersion();
 program.name("droid").description("Droid, teaching your AI new tricks").version(version);
 program.command("setup").description("Interactive wizard for global configuration").action(setupCommand);
-program.command("config").description("View or edit configuration").option("-e, --edit", "Open config in editor").option("-g, --get <key>", "Get a specific config value").option("-s, --set <key=value>", "Set a config value").action(configCommand);
+program.command("config").description("View or edit configuration").argument("[tool]", "Get merged config for a tool (for deterministic scripts)").option("-e, --edit", "Open config in editor").option("-g, --get <key>", "Get a specific config value").option("-s, --set <key=value>", "Set a config value").action(configCommand);
 program.command("tools").description("Browse and manage available tools").action(skillsCommand);
 program.command("install <tool>").description("Install a tool and run its setup wizard").action(installCommand);
 program.command("uninstall <tool>").description("Uninstall a tool").action(uninstallCommand);
 program.command("update").description("Update droid and installed tools").option("--tools", "Only update tools").option("--cli", "Only update the CLI").argument("[tool]", "Update a specific tool").action(updateCommand);
 program.command("tui").description("Launch interactive TUI dashboard").action(tuiCommand);
+program.command("exec <tool> <script>").description("Execute a tool script").argument("[args...]", "Arguments to pass to the script").allowUnknownOption().action(execCommand);
 if (process.argv.length === 2) {
   tuiCommand();
 } else {