@orderful/droid 0.23.0 → 0.25.0

package/src/commands/exec.ts

@@ -0,0 +1,96 @@
+import chalk from 'chalk';
+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { loadConfig } from '../lib/config';
+import { getSkillsPath } from '../lib/platforms';
+
+/**
+ * Find the appropriate runtime for a tool file
+ */
+function getRuntime(toolPath: string): { cmd: string; args: string[] } | null {
+  if (toolPath.endsWith('.ts') || toolPath.endsWith('.js')) {
+    // Prefer bun, fall back to node
+    // For .ts files, bun can run directly; node needs tsx or ts-node
+    return { cmd: 'bun', args: ['run', toolPath] };
+  }
+
+  if (toolPath.endsWith('.py')) {
+    return { cmd: 'python3', args: [toolPath] };
+  }
+
+  return null;
+}
+
+/**
+ * Execute a tool script
+ *
+ * Usage: droid exec <tool> <script> [args...]
+ *
+ * Finds the script in the tool's scripts/ directory and runs it with the
+ * appropriate runtime (bun for .ts/.js, python3 for .py)
+ */
+export async function execCommand(
+  tool: string,
+  script: string,
+  args: string[]
+): Promise<void> {
+  const config = loadConfig();
+  const skillsPath = getSkillsPath(config.platform);
+  const toolDir = join(skillsPath, tool);
+
+  // Check tool exists
+  if (!existsSync(toolDir)) {
+    console.error(chalk.red(`Tool '${tool}' not found at ${toolDir}`));
+    process.exit(1);
+  }
+
+  // Find the script file
+  const scriptsDir = join(toolDir, 'scripts');
+  if (!existsSync(scriptsDir)) {
+    console.error(chalk.red(`No scripts directory in tool '${tool}'`));
+    process.exit(1);
+  }
+
+  // Try common extensions
+  const extensions = ['.ts', '.js', '.py'];
+  let scriptPath: string | null = null;
+
+  for (const ext of extensions) {
+    const candidate = join(scriptsDir, script + ext);
+    if (existsSync(candidate)) {
+      scriptPath = candidate;
+      break;
+    }
+  }
+
+  if (!scriptPath) {
+    console.error(chalk.red(`Script '${script}' not found in ${scriptsDir}`));
+    console.error(chalk.gray(`Looked for: ${extensions.map((e) => script + e).join(', ')}`));
+    process.exit(1);
+  }
+
+  // Get runtime
+  const runtime = getRuntime(scriptPath);
+  if (!runtime) {
+    console.error(chalk.red(`Unsupported script type: ${scriptPath}`));
+    process.exit(1);
+  }
+
+  // Execute the script
+  const fullArgs = [...runtime.args, ...args];
+
+  const child = spawn(runtime.cmd, fullArgs, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+  });
+
+  child.on('error', (err) => {
+    console.error(chalk.red(`Failed to execute tool: ${err.message}`));
+    process.exit(1);
+  });
+
+  child.on('close', (code) => {
+    process.exit(code ?? 0);
+  });
+}

package/src/commands/install.ts

@@ -45,7 +45,7 @@ export async function installCommand(toolName: string): Promise<void> {
     // Show next steps
     console.log(chalk.gray('\nNext steps:'));
     console.log(chalk.gray('  - Run your AI tool to start using it'));
-    console.log(chalk.gray(`  - Reconfigure anytime with \`droid\` → Configure`));
+    console.log(chalk.gray('  - Reconfigure anytime with `droid` → Configure'));
   } else {
     console.error(chalk.red(`✗ ${result.message}`));
     process.exit(1);

package/src/commands/setup.ts

@@ -280,17 +280,17 @@ export async function setupCommand(): Promise<void> {
     console.log(chalk.yellow('  You may need to manually configure your platform'));
   } else if (answers.platform === Platform.ClaudeCode) {
     if (added.length > 0) {
-      console.log(chalk.green(`✓ Added droid permissions to Claude Code settings`));
+      console.log(chalk.green('✓ Added droid permissions to Claude Code settings'));
     } else if (alreadyPresent) {
-      console.log(chalk.gray(`  Droid permissions already configured in Claude Code`));
+      console.log(chalk.gray('  Droid permissions already configured in Claude Code'));
     }
   } else if (answers.platform === Platform.OpenCode) {
     if (added.length > 0) {
-      console.log(chalk.green(`✓ Added opencode-skills plugin to OpenCode config`));
-      console.log(chalk.gray(`  This enables Claude Code-style skills in OpenCode`));
-      console.log(chalk.gray(`  Restart OpenCode to activate the plugin`));
+      console.log(chalk.green('✓ Added opencode-skills plugin to OpenCode config'));
+      console.log(chalk.gray('  This enables Claude Code-style skills in OpenCode'));
+      console.log(chalk.gray('  Restart OpenCode to activate the plugin'));
     } else if (alreadyPresent) {
-      console.log(chalk.gray(`  opencode-skills plugin already configured in OpenCode`));
+      console.log(chalk.gray('  opencode-skills plugin already configured in OpenCode'));
     }
   }
 

package/src/commands/tui.tsx

@@ -6,10 +6,15 @@ import {
   uninstallSkill,
   updateSkill,
 } from '../lib/skills';
-import { getBundledTools, isToolInstalled, getToolUpdateStatus } from '../lib/tools';
+import {
+  getBundledTools,
+  isToolInstalled,
+  getToolUpdateStatus,
+} from '../lib/tools';
 import { configExists, loadConfig, getAutoUpdateConfig } from '../lib/config';
 import { Platform, type ConfigOption, type ToolManifest } from '../lib/types';
 import { getVersion } from '../lib/version';
+import { runToolMigrations } from '../lib/migrations';
 import { type Tab, type View } from './tui/types';
 import { colors, MAX_VISIBLE_ITEMS } from './tui/constants';
 import { TabBar } from './tui/components/TabBar';
@@ -41,29 +46,47 @@ function App() {
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [selectedAction, setSelectedAction] = useState(0);
   const [scrollOffset, setScrollOffset] = useState(0);
-  const [message, setMessage] = useState<{ text: string; type: 'success' | 'error' } | null>(null);
+  const [message, setMessage] = useState<{
+    text: string;
+    type: 'success' | 'error';
+  } | null>(null);
   const [isEditingSettings, setIsEditingSettings] = useState(false);
-  const [readmeContent, setReadmeContent] = useState<{ title: string; content: string } | null>(null);
+  const [readmeContent, setReadmeContent] = useState<{
+    title: string;
+    content: string;
+  } | null>(null);
   const [previousView, setPreviousView] = useState<View>('detail'); // Track where to return from readme
 
-  const { updateInfo, isUpdating, handleUpdate, handleAlwaysUpdate } = useAppUpdate({
-    onUpdateSuccess: (msg) => {
-      exitMessage = msg;
-    },
-    onUpdateFailure: (error) => {
-      setMessage({ text: error, type: 'error' });
-      if (!configExists()) {
-        setView('setup');
-      } else {
-        setView('menu');
-      }
-    },
-  });
+  const { updateInfo, isUpdating, handleUpdate, handleAlwaysUpdate } =
+    useAppUpdate({
+      onUpdateSuccess: (msg) => {
+        exitMessage = msg;
+      },
+      onUpdateFailure: (error) => {
+        setMessage({ text: error, type: 'error' });
+        if (!configExists()) {
+          setView('setup');
+        } else {
+          setView('menu');
+        }
+      },
+    });
+
+  // Run droid meta-tool migration on startup (sync installed tools across platforms)
+  useEffect(() => {
+    const droidVersion = getVersion();
+    runToolMigrations('droid', droidVersion);
+  }, []);
 
   // Auto-update app if enabled and update available
   useEffect(() => {
     const autoUpdateConfig = getAutoUpdateConfig();
-    if (autoUpdateConfig.app && updateInfo.hasUpdate && view === 'welcome' && !isUpdating) {
+    if (
+      autoUpdateConfig.app &&
+      updateInfo.hasUpdate &&
+      view === 'welcome' &&
+      !isUpdating
+    ) {
       handleUpdate();
     }
   }, [updateInfo.hasUpdate, view, isUpdating, handleUpdate]);
@@ -122,163 +145,201 @@ function App() {
   // Keep skills for configure view (tools configure via their primary skill)
   const skills = getBundledSkills();
 
-  useInput((input, key) => {
-    if (message) setMessage(null);
-
-    if (input === 'q') {
-      exit();
-      return;
-    }
+  useInput(
+    (input, key) => {
+      if (message) setMessage(null);
 
-    if (view === 'menu') {
-      if (key.leftArrow) {
-        const newIndex = Math.max(0, tabIndex - 1);
-        setTabIndex(newIndex);
-        setActiveTab(tabs[newIndex].id);
-        setSelectedIndex(0);
-        setScrollOffset(0);
+      if (input === 'q') {
+        exit();
+        return;
       }
-      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);
-          // Scroll up if needed
-          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);
-          // Scroll down if needed
-          if (newIndex >= scrollOffset + MAX_VISIBLE_ITEMS) {
-            setScrollOffset(newIndex - MAX_VISIBLE_ITEMS + 1);
-          }
-          return newIndex;
-        });
-        setSelectedAction(0);
-      }
-      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') {
-        // Settings detail view - just enter to edit
-        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 as ToolManifest & { system?: boolean }).system === true : false;
-        // Explore, [Update], Configure, [Uninstall] or Explore, Install
-        // System tools don't have Uninstall, so one less action
-        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 as ToolManifest & { system?: boolean }).system === true;
-          // Build actions array to match ToolDetails
-          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') {
-            // Open the tool explorer view
-            setView('explorer');
-          } else if (actionId === 'update') {
-            // Update the primary skill of the tool
-            const primarySkill = tool.includes.skills.find(s => s.required)?.name || tool.name;
-            const result = updateSkill(primarySkill);
-            setMessage({
-              text: result.success ? `✓ Updated ${tool.name}` : `✗ ${result.message}`,
-              type: result.success ? 'success' : 'error',
-            });
-            if (result.success) {
-              setSelectedAction(0);
+        if (key.upArrow) {
+          setSelectedIndex((prev) => {
+            const newIndex = Math.max(0, prev - 1);
+            // Scroll up if needed
+            if (newIndex < scrollOffset) {
+              setScrollOffset(newIndex);
             }
-          } else if (actionId === 'configure') {
-            setView('configure');
-          } else if (actionId === 'uninstall') {
-            // Uninstall the primary skill of the tool
-            const primarySkill = tool.includes.skills.find(s => s.required)?.name || tool.name;
-            const result = uninstallSkill(primarySkill);
-            setMessage({
-              text: result.success ? `✓ Uninstalled ${tool.name}` : `✗ ${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);
+            // Scroll down if needed
+            if (newIndex >= scrollOffset + MAX_VISIBLE_ITEMS) {
+              setScrollOffset(newIndex - MAX_VISIBLE_ITEMS + 1);
             }
-          } else if (actionId === 'install') {
-            // Install the primary skill of the tool
-            const primarySkill = tool.includes.skills.find(s => s.required)?.name || tool.name;
-            const result = installSkill(primarySkill);
-            setMessage({
-              text: result.success ? `✓ Installed ${tool.name}` : `✗ ${result.message}`,
-              type: result.success ? 'success' : 'error',
-            });
-            if (result.success) {
-              // Check if tool has required config (options without defaults)
-              const configSchema = tool.config_schema || {};
-              const hasRequiredConfig = Object.values(configSchema).some(
-                (option) => (option as ConfigOption).default === undefined
-              );
-              if (hasRequiredConfig) {
-                // Go to configure view for required setup
-                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') {
+          // Settings detail view - just enter to edit
+          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 as ToolManifest & { system?: boolean }).system === true
+            : false;
+          // Explore, [Update], Configure, [Uninstall] or Explore, Install
+          // System tools don't have Uninstall, so one less action
+          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 as ToolManifest & { system?: boolean }).system === true;
+            // Build actions array to match ToolDetails
+            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') {
+              // Open the tool explorer view
+              setView('explorer');
+            } else if (actionId === 'update') {
+              // Update the primary skill of the tool
+              const primarySkill =
+                tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = updateSkill(primarySkill);
+              setMessage({
+                text: result.success
+                  ? `✓ Updated ${tool.name}`
+                  : `✗ ${result.message}`,
+                type: result.success ? 'success' : 'error',
+              });
+              if (result.success) {
+                setSelectedAction(0);
+              }
+            } else if (actionId === 'configure') {
+              setView('configure');
+            } else if (actionId === 'uninstall') {
+              // Uninstall the primary skill of the tool
+              const primarySkill =
+                tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = uninstallSkill(primarySkill);
+              setMessage({
+                text: result.success
+                  ? `✓ Uninstalled ${tool.name}`
+                  : `✗ ${result.message}`,
+                type: result.success ? 'success' : 'error',
+              });
+              if (result.success) {
                 setView('menu');
                 setSelectedAction(0);
               }
+            } else if (actionId === 'install') {
+              // Install the primary skill of the tool
+              const primarySkill =
+                tool.includes.skills.find((s) => s.required)?.name || tool.name;
+              const result = installSkill(primarySkill);
+              setMessage({
+                text: result.success
+                  ? `✓ Installed ${tool.name}`
+                  : `✗ ${result.message}`,
+                type: result.success ? 'success' : 'error',
+              });
+              if (result.success) {
+                // Check if tool has required config (options without defaults)
+                const configSchema = tool.config_schema || {};
+                const hasRequiredConfig = Object.values(configSchema).some(
+                  (option) => (option as ConfigOption).default === undefined,
+                );
+                if (hasRequiredConfig) {
+                  // Go to configure view for required setup
+                  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 selectedTool =
+    activeTab === 'tools' ? (tools[selectedIndex] ?? null) : null;
   // For configure view, we need the matching skill manifest
   const selectedSkillForConfig = selectedTool
-    ? skills.find(s => s.name === (selectedTool.includes.skills.find(sk => sk.required)?.name || selectedTool.name))
+    ? skills.find(
+        (s) =>
+          s.name ===
+          (selectedTool.includes.skills.find((sk) => sk.required)?.name ||
+            selectedTool.name),
+      )
     : null;
 
   if (view === 'welcome') {
@@ -356,7 +417,10 @@ function App() {
       <SkillConfigScreen
         skill={selectedSkillForConfig}
         onComplete={() => {
-          setMessage({ text: `✓ Configuration saved for ${selectedTool?.name || selectedSkillForConfig.name}`, type: 'success' });
+          setMessage({
+            text: `✓ Configuration saved for ${selectedTool?.name || selectedSkillForConfig.name}`,
+            type: 'success',
+          });
           setView('detail');
         }}
         onCancel={() => {
@@ -389,7 +453,9 @@ function App() {
         </Box>
         <Box paddingX={1}>
           <Text color={colors.textDim}>
-            {loadConfig().platform === Platform.ClaudeCode ? 'Claude Code' : 'OpenCode'}
+            {loadConfig().platform === Platform.ClaudeCode
+              ? 'Claude Code'
+              : 'OpenCode'}
           </Text>
         </Box>
 
@@ -407,18 +473,25 @@ function App() {
                   <Text color={colors.textDim}>↑ {scrollOffset} more</Text>
                 </Box>
               )}
-              {tools.slice(scrollOffset, scrollOffset + MAX_VISIBLE_ITEMS).map((tool, index) => (
-                <ToolItem
-                  key={tool.name}
-                  tool={tool}
-                  isSelected={scrollOffset + index === selectedIndex}
-                  isActive={scrollOffset + index === selectedIndex && view === 'detail'}
-                  wasAutoUpdated={autoUpdatedTools.includes(tool.name)}
-                />
-              ))}
+              {tools
+                .slice(scrollOffset, scrollOffset + MAX_VISIBLE_ITEMS)
+                .map((tool, index) => (
+                  <ToolItem
+                    key={tool.name}
+                    tool={tool}
+                    isSelected={scrollOffset + index === selectedIndex}
+                    isActive={
+                      scrollOffset + index === selectedIndex &&
+                      view === 'detail'
+                    }
+                    wasAutoUpdated={autoUpdatedTools.includes(tool.name)}
+                  />
+                ))}
               {scrollOffset + MAX_VISIBLE_ITEMS < tools.length && (
                 <Box paddingX={1}>
-                  <Text color={colors.textDim}>↓ {tools.length - scrollOffset - MAX_VISIBLE_ITEMS} more</Text>
+                  <Text color={colors.textDim}>
+                    ↓ {tools.length - scrollOffset - MAX_VISIBLE_ITEMS} more
+                  </Text>
                 </Box>
               )}
               {tools.length > MAX_VISIBLE_ITEMS && (
@@ -439,7 +512,11 @@ function App() {
         {/* Message */}
         {message && (
           <Box paddingX={1} marginTop={1}>
-            <Text color={message.type === 'success' ? colors.success : colors.error}>{message.text}</Text>
+            <Text
+              color={message.type === 'success' ? colors.success : colors.error}
+            >
+              {message.text}
+            </Text>
           </Box>
         )}
 
@@ -453,13 +530,15 @@ function App() {
 
       {/* Right column */}
       {activeTab === 'tools' && (
-        <ToolDetails tool={selectedTool} isFocused={view === 'detail'} selectedAction={selectedAction} />
+        <ToolDetails
+          tool={selectedTool}
+          isFocused={view === 'detail'}
+          selectedAction={selectedAction}
+        />
       )}
 
       {activeTab === 'settings' && (
-        <SettingsDetails
-          isFocused={view === 'detail'}
-        />
+        <SettingsDetails isFocused={view === 'detail'} />
       )}
     </Box>
   );