soulhubcli 1.0.12 → 1.0.14

package/dist/index.cjs

@@ -13284,6 +13284,7 @@ var import_node_fs8 = __toESM(require("fs"), 1);
 var import_node_path11 = __toESM(require("path"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
 var import_node_child_process = require("child_process");
+var import_node_readline = __toESM(require("readline"), 1);
 
 // node_modules/js-yaml/dist/js-yaml.mjs
 function isNothing(subject) {
@@ -19038,7 +19039,7 @@ function findOpenClawDir(customDir) {
     }
     return resolved;
   }
-  const envHome = process.env.OPENCLAW_HOME;
+  const envHome = process.env.OPENCLAW_HOME || process.env.LIGHTCLAW_HOME;
   if (envHome) {
     const resolved = import_node_path11.default.resolve(envHome);
     if (import_node_fs8.default.existsSync(resolved)) {
@@ -19046,9 +19047,12 @@ function findOpenClawDir(customDir) {
     }
     return resolved;
   }
+  const home = process.env.HOME || "~";
   const candidates = [
-    import_node_path11.default.join(process.env.HOME || "~", ".openclaw"),
-    import_node_path11.default.join(process.cwd(), ".openclaw")
+    import_node_path11.default.join(home, ".openclaw"),
+    import_node_path11.default.join(home, ".lightclaw"),
+    import_node_path11.default.join(process.cwd(), ".openclaw"),
+    import_node_path11.default.join(process.cwd(), ".lightclaw")
   ];
   for (const candidate of candidates) {
     if (import_node_fs8.default.existsSync(candidate)) {
@@ -19057,6 +19061,65 @@ function findOpenClawDir(customDir) {
   }
   return null;
 }
+function findAllClawDirs(customDir) {
+  if (customDir) {
+    const resolved = import_node_path11.default.resolve(customDir);
+    return import_node_fs8.default.existsSync(resolved) ? [resolved] : [resolved];
+  }
+  const envHome = process.env.OPENCLAW_HOME || process.env.LIGHTCLAW_HOME;
+  if (envHome) {
+    const resolved = import_node_path11.default.resolve(envHome);
+    return [resolved];
+  }
+  const home = process.env.HOME || "~";
+  const candidates = [
+    import_node_path11.default.join(home, ".openclaw"),
+    import_node_path11.default.join(home, ".lightclaw"),
+    import_node_path11.default.join(process.cwd(), ".openclaw"),
+    import_node_path11.default.join(process.cwd(), ".lightclaw")
+  ];
+  const existing = candidates.filter((c) => import_node_fs8.default.existsSync(c));
+  const seen = /* @__PURE__ */ new Set();
+  return existing.filter((c) => {
+    const real = import_node_fs8.default.realpathSync(c);
+    if (seen.has(real)) return false;
+    seen.add(real);
+    return true;
+  });
+}
+async function promptSelectClawDir(customDir) {
+  const dirs = findAllClawDirs(customDir);
+  if (dirs.length === 0) {
+    return null;
+  }
+  if (dirs.length === 1) {
+    return dirs[0];
+  }
+  console.log();
+  console.log("  Detected multiple Claw installations:");
+  console.log();
+  dirs.forEach((dir, index) => {
+    const brand = detectClawBrand(dir);
+    console.log(`    ${index + 1}) ${brand}  ${dir}`);
+  });
+  console.log();
+  const rl = import_node_readline.default.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(`  Please select target (1-${dirs.length}): `, (answer) => {
+      rl.close();
+      const idx = parseInt(answer.trim(), 10);
+      if (idx >= 1 && idx <= dirs.length) {
+        resolve(dirs[idx - 1]);
+      } else {
+        console.log("  Invalid selection, operation cancelled.");
+        resolve(null);
+      }
+    });
+  });
+}
 function getConfigPath() {
   const home = process.env.HOME || "~";
   return import_node_path11.default.join(home, ".soulhub", "config.json");
@@ -19111,8 +19174,22 @@ function checkMainAgentExists(clawDir) {
     workspaceDir
   };
 }
+function detectClawBrand(clawDir) {
+  const dirName = import_node_path11.default.basename(clawDir).toLowerCase();
+  if (dirName.includes("lightclaw")) {
+    return "LightClaw";
+  }
+  if (import_node_fs8.default.existsSync(import_node_path11.default.join(clawDir, "lightclaw.json"))) {
+    return "LightClaw";
+  }
+  return "OpenClaw";
+}
+function getClawConfigFileName(clawDir) {
+  const brand = detectClawBrand(clawDir);
+  return brand === "LightClaw" ? "lightclaw.json" : "openclaw.json";
+}
 function getOpenClawConfigPath(clawDir) {
-  return import_node_path11.default.join(clawDir, "openclaw.json");
+  return import_node_path11.default.join(clawDir, getClawConfigFileName(clawDir));
 }
 function readOpenClawConfig(clawDir) {
   const configPath = getOpenClawConfigPath(clawDir);
@@ -19208,32 +19285,6 @@ function detectPackageKind(dir) {
   }
   return "unknown";
 }
-function checkOpenClawInstalled(customDir) {
-  const clawDir = findOpenClawDir(customDir);
-  if (clawDir) {
-    return {
-      installed: true,
-      clawDir,
-      message: `OpenClaw detected at: ${clawDir}`
-    };
-  }
-  try {
-    (0, import_node_child_process.execSync)("which openclaw 2>/dev/null || where openclaw 2>nul", {
-      stdio: "pipe"
-    });
-    return {
-      installed: true,
-      clawDir: null,
-      message: "OpenClaw command found in PATH, but workspace directory not detected."
-    };
-  } catch {
-  }
-  return {
-    installed: false,
-    clawDir: null,
-    message: "OpenClaw is not installed. Please install OpenClaw first, use --claw-dir to specify OpenClaw directory, or set OPENCLAW_HOME environment variable."
-  };
-}
 function backupAgentWorkspace(workspaceDir) {
   if (!import_node_fs8.default.existsSync(workspaceDir)) {
     return null;
@@ -19333,7 +19384,7 @@ function generateBackupId() {
 }
 function createBackupRecord(installType, packageName, clawDir) {
   let openclawJsonSnapshot = null;
-  const configPath = import_node_path11.default.join(clawDir, "openclaw.json");
+  const configPath = getOpenClawConfigPath(clawDir);
   if (import_node_fs8.default.existsSync(configPath)) {
     try {
       openclawJsonSnapshot = import_node_fs8.default.readFileSync(configPath, "utf-8");
@@ -19375,30 +19426,31 @@ var CATEGORY_LABELS = {
 };
 function registerAgentToOpenClaw(agentName, workspaceDir, _clawDir) {
   const agentId = agentName.toLowerCase().replace(/[\s_]+/g, "-");
-  logger.debug(`Registering agent to OpenClaw`, { agentId, workspaceDir });
+  logger.debug(`Registering agent to OpenClaw/LightClaw`, { agentId, workspaceDir });
   try {
+    const clawCmd = detectClawCommand();
     (0, import_node_child_process.execSync)(
-      `openclaw agents add "${agentId}" --workspace "${workspaceDir}" --non-interactive --json`,
+      `${clawCmd} agents add "${agentId}" --workspace "${workspaceDir}" --non-interactive --json`,
       { stdio: "pipe", timeout: 15e3 }
     );
     return {
       success: true,
-      message: `Agent "${agentId}" registered via OpenClaw CLI.`
+      message: `Agent "${agentId}" registered via CLI.`
     };
   } catch (cliError) {
     const stderr = cliError && typeof cliError === "object" && "stderr" in cliError ? String(cliError.stderr) : "";
     if (stderr.includes("already exists")) {
       return {
         success: true,
-        message: `Agent "${agentId}" already registered in OpenClaw.`
+        message: `Agent "${agentId}" already registered.`
       };
     }
     const isCommandNotFound = cliError && typeof cliError === "object" && "code" in cliError && cliError.code === "ENOENT" || stderr.includes("not found") || stderr.includes("not recognized");
     if (isCommandNotFound) {
-      logger.error(`OpenClaw CLI not found`);
+      logger.error(`OpenClaw/LightClaw CLI not found`);
       return {
         success: false,
-        message: "OpenClaw CLI not found. Please install OpenClaw first: https://github.com/anthropics/openclaw"
+        message: "OpenClaw/LightClaw CLI not found. Please install first."
       };
     }
     const errMsg = cliError instanceof Error ? cliError.message : String(cliError);
@@ -19409,17 +19461,31 @@ function registerAgentToOpenClaw(agentName, workspaceDir, _clawDir) {
     };
   }
 }
+function detectClawCommand() {
+  try {
+    (0, import_node_child_process.execSync)("which lightclaw 2>/dev/null || where lightclaw 2>nul", { stdio: "pipe" });
+    return "lightclaw";
+  } catch {
+  }
+  try {
+    (0, import_node_child_process.execSync)("which openclaw 2>/dev/null || where openclaw 2>nul", { stdio: "pipe" });
+    return "openclaw";
+  } catch {
+  }
+  return "openclaw";
+}
 function restartOpenClawGateway() {
-  logger.debug(`Restarting OpenClaw Gateway`);
+  const clawCmd = detectClawCommand();
+  logger.debug(`Restarting ${clawCmd} Gateway`);
   try {
-    (0, import_node_child_process.execSync)("openclaw gateway restart", {
+    (0, import_node_child_process.execSync)(`${clawCmd} gateway restart`, {
       stdio: "pipe",
       timeout: 3e4
       // 30 秒超时
     });
     return {
       success: true,
-      message: "OpenClaw Gateway restarted successfully."
+      message: `${clawCmd} Gateway restarted successfully.`
     };
   } catch (error) {
     const stderr = error && typeof error === "object" && "stderr" in error ? String(error.stderr).trim() : "";
@@ -19432,7 +19498,7 @@ function restartOpenClawGateway() {
 }
 
 // src/commands/search.ts
-var searchCommand = new Command("search").description("Search for agent templates in the SoulHub registry").argument("[query]", "Search query (matches name, description, tags)").option("-c, --category <category>", "Filter by category").option("-l, --limit <number>", "Max results to show", "20").action(async (query, options) => {
+var searchCommand = new Command("search").description("Search for agents in the SoulHub registry").argument("[query]", "Search query (matches name, description, tags)").option("-c, --category <category>", "Filter by category").option("-l, --limit <number>", "Max results to show", "20").action(async (query, options) => {
   try {
     const index = await fetchIndex();
     let agents = index.agents;
@@ -19498,7 +19564,7 @@ var searchCommand = new Command("search").description("Search for agent template
 });
 
 // src/commands/info.ts
-var infoCommand = new Command("info").description("View detailed information about an agent template").argument("<name>", "Agent name").option("--identity", "Show IDENTITY.md content").option("--soul", "Show SOUL.md content").action(async (name, options) => {
+var infoCommand = new Command("info").description("Show details of an agent (identity, soul, skills, etc.)").argument("<name>", "Agent name").option("--identity", "Show IDENTITY.md content").option("--soul", "Show SOUL.md content").action(async (name, options) => {
   try {
     const index = await fetchIndex();
     const agent = index.agents.find((a) => a.name === name);
@@ -19659,22 +19725,30 @@ function createSpinner(initialText = "") {
 // src/commands/install.ts
 var import_node_fs9 = __toESM(require("fs"), 1);
 var import_node_path12 = __toESM(require("path"), 1);
-var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option(
+async function resolveClawDir(clawDir) {
+  if (clawDir) {
+    return findOpenClawDir(clawDir);
+  }
+  return promptSelectClawDir();
+}
+var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry (default: as worker)").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option("--main", "Install as main agent (default is worker/sub-agent)").option(
   "--dir <path>",
-  "Target directory (defaults to OpenClaw workspace)"
+  "Target directory (defaults to OpenClaw/LightClaw workspace)"
 ).option(
   "--claw-dir <path>",
-  "OpenClaw installation directory (overrides OPENCLAW_HOME env var, defaults to ~/.openclaw)"
+  "OpenClaw/LightClaw installation directory (overrides OPENCLAW_HOME/LIGHTCLAW_HOME env var, defaults to ~/.openclaw or ~/.lightclaw)"
 ).action(async (name, options) => {
   try {
+    const asMain = !!options.main;
     if (options.from) {
-      await installFromSource(options.from, options.dir, options.clawDir);
+      await installFromSource(options.from, options.dir, options.clawDir, asMain);
     } else if (name) {
-      await installFromRegistry(name, options.dir, options.clawDir);
+      await installFromRegistry(name, options.dir, options.clawDir, asMain);
     } else {
       console.error(source_default.red("Please specify an agent or team name, or use --from to install from a local source."));
       console.log(source_default.dim("  Examples:"));
-      console.log(source_default.dim("    soulhub install writer-wechat          # \u4ECE registry \u5B89\u88C5\u5355 agent"));
+      console.log(source_default.dim("    soulhub install writer-wechat          # \u5B89\u88C5\u4E3A\u5B50 agent (workspace-writer-wechat/)"));
+      console.log(source_default.dim("    soulhub install writer-wechat --main   # \u5B89\u88C5\u4E3A\u4E3B agent (workspace/)"));
       console.log(source_default.dim("    soulhub install dev-squad              # \u4ECE registry \u5B89\u88C5\u56E2\u961F"));
       console.log(source_default.dim("    soulhub install --from ./agent-team/   # \u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5"));
       process.exit(1);
@@ -19688,15 +19762,15 @@ var installCommand = new Command("install").description("Install an agent or tea
     process.exit(1);
   }
 });
-async function installFromRegistry(name, targetDir, clawDir) {
+async function installFromRegistry(name, targetDir, clawDir, asMain = false) {
   const spinner = createSpinner(`Checking registry for ${source_default.cyan(name)}...`).start();
   const index = await fetchIndex();
   const agent = index.agents.find((a) => a.name === name);
   const recipe = index.recipes.find((r) => r.name === name);
   if (agent && !recipe) {
     spinner.stop();
-    logger.info(`Installing single agent from registry: ${name}`);
-    await installSingleAgent(name, targetDir, clawDir);
+    logger.info(`Installing single agent from registry: ${name}, asMain=${asMain}`);
+    await installSingleAgent(name, targetDir, clawDir, asMain);
   } else if (recipe) {
     spinner.stop();
     logger.info(`Installing team recipe from registry: ${name}`);
@@ -19707,16 +19781,20 @@ async function installFromRegistry(name, targetDir, clawDir) {
     console.log(source_default.dim("  Use 'soulhub search' to find available agents and teams."));
   }
 }
-async function installSingleAgent(name, targetDir, clawDir) {
+async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
   const spinner = createSpinner(`Checking environment...`).start();
+  let selectedClawDir = null;
   if (!targetDir) {
-    const clawCheck = checkOpenClawInstalled(clawDir);
-    if (!clawCheck.installed) {
-      spinner.fail("OpenClaw is not installed.");
+    spinner.stop();
+    selectedClawDir = await resolveClawDir(clawDir);
+    if (!selectedClawDir) {
+      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
       printOpenClawInstallHelp();
       return;
     }
-    spinner.text = source_default.dim(`OpenClaw detected: ${clawCheck.clawDir || "via PATH"}`);
+    spinner.start();
+    const brand = detectClawBrand(selectedClawDir);
+    spinner.text = source_default.dim(`${brand} detected: ${selectedClawDir}`);
   }
   spinner.text = `Fetching agent ${source_default.cyan(name)}...`;
   const index = await fetchIndex();
@@ -19727,21 +19805,17 @@ async function installSingleAgent(name, targetDir, clawDir) {
     return;
   }
   let workspaceDir;
+  const agentId = name.toLowerCase().replace(/[\s_]+/g, "-");
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
+  } else if (asMain) {
+    workspaceDir = getMainWorkspaceDir(selectedClawDir);
   } else {
-    const resolvedClawDir = findOpenClawDir(clawDir);
-    if (!resolvedClawDir) {
-      spinner.fail("OpenClaw workspace directory not found.");
-      printOpenClawInstallHelp();
-      return;
-    }
-    workspaceDir = getMainWorkspaceDir(resolvedClawDir);
+    workspaceDir = getWorkspaceDir(selectedClawDir, agentId);
   }
-  const resolvedClawDirForBackup = findOpenClawDir(clawDir);
-  const backupRecord = !targetDir ? createBackupRecord("single-agent", name, resolvedClawDirForBackup) : null;
-  if (!targetDir) {
-    const mainCheck = checkMainAgentExists(resolvedClawDirForBackup);
+  const backupRecord = !targetDir ? createBackupRecord("single-agent", name, selectedClawDir) : null;
+  if (!targetDir && asMain) {
+    const mainCheck = checkMainAgentExists(selectedClawDir);
     if (mainCheck.hasContent) {
       spinner.warn(
         `Existing main agent detected. Backing up workspace...`
@@ -19758,7 +19832,21 @@ async function installSingleAgent(name, targetDir, clawDir) {
         });
       }
     }
-  } else {
+  } else if (!targetDir && !asMain) {
+    if (import_node_fs9.default.existsSync(workspaceDir)) {
+      const backupDir = backupAgentWorkspace(workspaceDir);
+      if (backupDir) {
+        console.log(source_default.yellow(`  \u26A0 Existing worker ${agentId} backed up to: ${backupDir}`));
+        addBackupItem(backupRecord, {
+          originalPath: workspaceDir,
+          backupPath: backupDir,
+          method: "cp",
+          role: "worker",
+          agentId
+        });
+      }
+    }
+  } else if (targetDir) {
     const backupDir = backupAgentWorkspace(workspaceDir);
     if (backupDir) {
       console.log(source_default.yellow(`  \u26A0 Existing agent backed up to: ${backupDir}`));
@@ -19768,10 +19856,19 @@ async function installSingleAgent(name, targetDir, clawDir) {
     import_node_fs9.default.mkdirSync(workspaceDir, { recursive: true });
   }
   if (!targetDir) {
-    spinner.text = `Registering ${source_default.cyan(agent.displayName)} as main agent...`;
-    const resolvedClawDir = findOpenClawDir(clawDir);
-    addAgentToOpenClawConfig(resolvedClawDir, "main", name, true);
-    spinner.text = source_default.dim(`Main agent registered in openclaw.json`);
+    if (asMain) {
+      spinner.text = `Registering ${source_default.cyan(agent.displayName)} as main agent...`;
+      addAgentToOpenClawConfig(selectedClawDir, "main", name, true);
+      spinner.text = source_default.dim(`Main agent registered in config`);
+    } else {
+      spinner.text = `Registering ${source_default.cyan(agent.displayName)} as worker agent...`;
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      if (!regResult.success) {
+        spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
+        return;
+      }
+      spinner.text = source_default.dim(`Worker agent ${agentId} registered in config`);
+    }
   }
   spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
   const pkgDir = await downloadAgentPackage(name, agent.version);
@@ -19779,17 +19876,23 @@ async function installSingleAgent(name, targetDir, clawDir) {
   import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
   recordInstall(name, agent.version, workspaceDir);
   if (backupRecord) {
-    backupRecord.installedMainAgent = name;
+    if (asMain) {
+      backupRecord.installedMainAgent = name;
+    } else {
+      backupRecord.installedWorkerIds = [agentId];
+    }
     commitBackupRecord(backupRecord);
   }
-  logger.info(`Single agent installed: ${name}`, { version: agent.version, workspace: workspaceDir });
+  const roleLabel = asMain ? "main agent" : "worker agent";
+  const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
+  logger.info(`Single agent installed as ${roleLabel}: ${name}`, { version: agent.version, workspace: workspaceDir });
   spinner.succeed(
-    `${source_default.cyan.bold(agent.displayName)} installed as main agent!`
+    `${source_default.cyan.bold(agent.displayName)} installed as ${roleLabel}!`
   );
   console.log();
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Version:")}  ${agent.version}`);
-  console.log(`  ${source_default.dim("Type:")}     ${source_default.blue("Single Agent (Main)")}`);
+  console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
   if (!targetDir) {
     await tryRestartGateway();
   }
@@ -19797,19 +19900,19 @@ async function installSingleAgent(name, targetDir, clawDir) {
 }
 async function installRecipeFromRegistry(name, recipe, targetDir, clawDir) {
   const spinner = createSpinner(`Installing team ${source_default.cyan(recipe.displayName)}...`).start();
-  if (!targetDir) {
-    const clawCheck = checkOpenClawInstalled(clawDir);
-    if (!clawCheck.installed) {
-      spinner.fail("OpenClaw is not installed.");
+  let resolvedClawDir;
+  if (targetDir) {
+    resolvedClawDir = import_node_path12.default.resolve(targetDir);
+  } else {
+    spinner.stop();
+    const selected = await resolveClawDir(clawDir);
+    if (!selected) {
+      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
       printOpenClawInstallHelp();
       return;
     }
-  }
-  const resolvedClawDir = targetDir ? import_node_path12.default.resolve(targetDir) : findOpenClawDir(clawDir);
-  if (!resolvedClawDir) {
-    spinner.fail("OpenClaw workspace directory not found.");
-    printOpenClawInstallHelp();
-    return;
+    resolvedClawDir = selected;
+    spinner.start();
   }
   spinner.text = `Fetching team configuration...`;
   let pkg;
@@ -19887,7 +19990,7 @@ async function installRecipeFromRegistry(name, recipe, targetDir, clawDir) {
     await tryRestartGateway();
   }
 }
-async function installFromSource(source, targetDir, clawDir) {
+async function installFromSource(source, targetDir, clawDir, asMain = false) {
   const spinner = createSpinner("Analyzing package...").start();
   let packageDir;
   let tempDir = null;
@@ -19941,7 +20044,7 @@ async function installFromSource(source, targetDir, clawDir) {
   spinner.text = `Detected package type: ${source_default.blue(kind)}`;
   if (kind === "agent") {
     spinner.stop();
-    await installSingleAgentFromDir(packageDir, targetDir, clawDir);
+    await installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain);
   } else if (kind === "team") {
     spinner.stop();
     await installTeamFromDir(packageDir, targetDir, clawDir);
@@ -19953,33 +20056,33 @@ async function installFromSource(source, targetDir, clawDir) {
     import_node_fs9.default.rmSync(tempDir, { recursive: true, force: true });
   }
 }
-async function installSingleAgentFromDir(packageDir, targetDir, clawDir) {
+async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain = false) {
   const spinner = createSpinner("Installing single agent...").start();
   const pkg = readSoulHubPackage(packageDir);
   const agentName = pkg?.name || import_node_path12.default.basename(packageDir);
+  let selectedClawDir = null;
   if (!targetDir) {
-    const clawCheck = checkOpenClawInstalled(clawDir);
-    if (!clawCheck.installed) {
-      spinner.fail("OpenClaw is not installed.");
+    spinner.stop();
+    selectedClawDir = await resolveClawDir(clawDir);
+    if (!selectedClawDir) {
+      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
       printOpenClawInstallHelp();
       return;
     }
+    spinner.start();
   }
   let workspaceDir;
+  const agentId = agentName.toLowerCase().replace(/[\s_]+/g, "-");
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
+  } else if (asMain) {
+    workspaceDir = getMainWorkspaceDir(selectedClawDir);
   } else {
-    const resolvedClawDir = findOpenClawDir(clawDir);
-    if (!resolvedClawDir) {
-      spinner.fail("OpenClaw workspace directory not found.");
-      return;
-    }
-    workspaceDir = getMainWorkspaceDir(resolvedClawDir);
+    workspaceDir = getWorkspaceDir(selectedClawDir, agentId);
   }
-  const localBackupRecord = !targetDir ? createBackupRecord("single-agent-local", agentName, findOpenClawDir(clawDir)) : null;
-  if (!targetDir) {
-    const resolvedClawDir = findOpenClawDir(clawDir);
-    const mainCheck = checkMainAgentExists(resolvedClawDir);
+  const localBackupRecord = !targetDir ? createBackupRecord("single-agent-local", agentName, selectedClawDir) : null;
+  if (!targetDir && asMain) {
+    const mainCheck = checkMainAgentExists(selectedClawDir);
     if (mainCheck.hasContent) {
       spinner.warn("Existing main agent detected. Backing up...");
       const backupDir = backupAgentWorkspace(workspaceDir);
@@ -19994,28 +20097,56 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir) {
         });
       }
     }
+  } else if (!targetDir && !asMain) {
+    if (import_node_fs9.default.existsSync(workspaceDir)) {
+      const backupDir = backupAgentWorkspace(workspaceDir);
+      if (backupDir) {
+        console.log(source_default.yellow(`  \u26A0 Existing worker ${agentId} backed up to: ${backupDir}`));
+        addBackupItem(localBackupRecord, {
+          originalPath: workspaceDir,
+          backupPath: backupDir,
+          method: "cp",
+          role: "worker",
+          agentId
+        });
+      }
+    }
   }
   if (!import_node_fs9.default.existsSync(workspaceDir)) {
     import_node_fs9.default.mkdirSync(workspaceDir, { recursive: true });
   }
   if (!targetDir) {
-    spinner.text = `Registering ${source_default.cyan(agentName)} as main agent...`;
-    const resolvedClawDir = findOpenClawDir(clawDir);
-    addAgentToOpenClawConfig(resolvedClawDir, "main", agentName, true);
+    if (asMain) {
+      spinner.text = `Registering ${source_default.cyan(agentName)} as main agent...`;
+      addAgentToOpenClawConfig(selectedClawDir, "main", agentName, true);
+    } else {
+      spinner.text = `Registering ${source_default.cyan(agentName)} as worker agent...`;
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      if (!regResult.success) {
+        spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
+        return;
+      }
+    }
   }
   spinner.text = `Copying soul files...`;
   copyAgentFilesFromDir(packageDir, workspaceDir);
   recordInstall(agentName, pkg?.version || "local", workspaceDir);
   if (localBackupRecord) {
-    localBackupRecord.installedMainAgent = agentName;
+    if (asMain) {
+      localBackupRecord.installedMainAgent = agentName;
+    } else {
+      localBackupRecord.installedWorkerIds = [agentId];
+    }
     commitBackupRecord(localBackupRecord);
   }
-  logger.info(`Single agent installed from dir: ${agentName}`, { source: packageDir, workspace: workspaceDir });
-  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as main agent!`);
+  const roleLabel = asMain ? "main agent" : "worker agent";
+  const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
+  logger.info(`Single agent installed from dir as ${roleLabel}: ${agentName}`, { source: packageDir, workspace: workspaceDir });
+  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as ${roleLabel}!`);
   console.log();
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Source:")}   ${packageDir}`);
-  console.log(`  ${source_default.dim("Type:")}     ${source_default.blue("Single Agent (Main)")}`);
+  console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
   if (!targetDir) {
     await tryRestartGateway();
   }
@@ -20028,18 +20159,19 @@ async function installTeamFromDir(packageDir, targetDir, clawDir) {
     spinner.fail("Invalid team package. Missing soulhub.yaml.");
     return;
   }
-  if (!targetDir) {
-    const clawCheck = checkOpenClawInstalled(clawDir);
-    if (!clawCheck.installed) {
-      spinner.fail("OpenClaw is not installed.");
+  let resolvedClawDir;
+  if (targetDir) {
+    resolvedClawDir = import_node_path12.default.resolve(targetDir);
+  } else {
+    spinner.stop();
+    const selected = await resolveClawDir(clawDir);
+    if (!selected) {
+      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
       printOpenClawInstallHelp();
       return;
     }
-  }
-  const resolvedClawDir = targetDir ? import_node_path12.default.resolve(targetDir) : findOpenClawDir(clawDir);
-  if (!resolvedClawDir) {
-    spinner.fail("OpenClaw workspace directory not found.");
-    return;
+    resolvedClawDir = selected;
+    spinner.start();
   }
   const teamBackupRecord = !targetDir ? createBackupRecord("team-local", pkg.name, resolvedClawDir) : null;
   if (!targetDir) {
@@ -20199,11 +20331,11 @@ async function extractZipToDir(zip, targetDir) {
   }
 }
 function printOpenClawInstallHelp() {
-  console.log(source_default.dim("  Please install OpenClaw first, or use one of the following options:"));
-  console.log(source_default.dim("  --claw-dir <path>    Specify OpenClaw installation directory"));
-  console.log(source_default.dim("  --dir <path>         Specify agent target directory directly"));
-  console.log(source_default.dim("  OPENCLAW_HOME=<path> Set environment variable"));
-  console.log(source_default.dim("  Visit: https://github.com/anthropics/openclaw for installation instructions."));
+  console.log(source_default.dim("  Please install OpenClaw or LightClaw first, or use one of the following options:"));
+  console.log(source_default.dim("  --claw-dir <path>            Specify OpenClaw/LightClaw installation directory"));
+  console.log(source_default.dim("  --dir <path>                 Specify agent target directory directly"));
+  console.log(source_default.dim("  OPENCLAW_HOME=<path>         Set environment variable (for OpenClaw)"));
+  console.log(source_default.dim("  LIGHTCLAW_HOME=<path>        Set environment variable (for LightClaw)"));
 }
 function printTeamSummary(pkg, workerIds) {
   console.log();
@@ -20221,20 +20353,22 @@ function printTeamSummary(pkg, workerIds) {
   console.log();
 }
 async function tryRestartGateway() {
-  const restartSpinner = createSpinner("Restarting OpenClaw Gateway...").start();
+  const clawCmd = detectClawCommand();
+  const brandName = clawCmd === "lightclaw" ? "LightClaw" : "OpenClaw";
+  const restartSpinner = createSpinner(`Restarting ${brandName} Gateway...`).start();
   const result = restartOpenClawGateway();
   if (result.success) {
-    restartSpinner.succeed("OpenClaw Gateway restarted successfully.");
+    restartSpinner.succeed(`${brandName} Gateway restarted successfully.`);
   } else {
-    restartSpinner.warn("Failed to restart OpenClaw Gateway.");
+    restartSpinner.warn(`Failed to restart ${brandName} Gateway.`);
     console.log(source_default.yellow(`  Reason: ${result.message}`));
     console.log(source_default.dim("  Please restart manually:"));
-    console.log(source_default.dim("    openclaw gateway restart"));
+    console.log(source_default.dim(`    ${clawCmd} gateway restart`));
   }
 }
 
 // src/commands/list.ts
-var listCommand = new Command("list").description("List installed agent templates").alias("ls").action(async () => {
+var listCommand = new Command("list").description("List installed agents").alias("ls").action(async () => {
   try {
     const config = loadConfig();
     if (config.installed.length === 0) {
@@ -20274,7 +20408,7 @@ var listCommand = new Command("list").description("List installed agent template
 
 // src/commands/update.ts
 var import_node_fs10 = __toESM(require("fs"), 1);
-var updateCommand = new Command("update").description("Update installed agent templates to latest versions").argument("[name]", "Agent name to update (updates all if omitted)").action(async (name) => {
+var updateCommand = new Command("update").description("Update installed agents to latest versions").argument("[name]", "Agent name to update (updates all if omitted)").action(async (name) => {
   try {
     const config = loadConfig();
     if (config.installed.length === 0) {
@@ -20335,7 +20469,7 @@ var import_node_fs11 = __toESM(require("fs"), 1);
 var import_node_path13 = __toESM(require("path"), 1);
 var rollbackCommand = new Command("rollback").description("Rollback to a previous agent installation state").option("--list", "List available rollback records").option("--id <id>", "Rollback to a specific backup record by ID").option(
   "--claw-dir <path>",
-  "OpenClaw installation directory (overrides OPENCLAW_HOME env var)"
+  "OpenClaw/LightClaw installation directory (overrides OPENCLAW_HOME/LIGHTCLAW_HOME env var)"
 ).action(async (options) => {
   try {
     if (options.list) {
@@ -20407,20 +20541,21 @@ async function performRollback(recordId, clawDir) {
   const spinner = createSpinner(
     `Rolling back ${source_default.cyan(record.packageName)}...`
   ).start();
-  const resolvedClawDir = findOpenClawDir(clawDir) || record.clawDir;
+  const resolvedClawDir = clawDir ? findOpenClawDir(clawDir) || record.clawDir : await promptSelectClawDir() || record.clawDir;
   if (!resolvedClawDir || !import_node_fs11.default.existsSync(resolvedClawDir)) {
-    spinner.fail(`OpenClaw directory not found: ${record.clawDir}`);
+    spinner.fail(`OpenClaw/LightClaw directory not found: ${record.clawDir}`);
     return;
   }
+  const brand = detectClawBrand(resolvedClawDir);
   if (record.openclawJsonSnapshot) {
-    spinner.text = "Restoring openclaw.json...";
+    spinner.text = `Restoring ${brand.toLowerCase()}.json...`;
     try {
       const configObj = JSON.parse(record.openclawJsonSnapshot);
       writeOpenClawConfig(resolvedClawDir, configObj);
-      logger.info("openclaw.json restored from snapshot", { recordId: record.id });
+      logger.info(`${brand.toLowerCase()}.json restored from snapshot`, { recordId: record.id });
     } catch (err) {
-      logger.error("Failed to restore openclaw.json", { error: err });
-      console.log(source_default.yellow("  \u26A0 Failed to restore openclaw.json, skipping..."));
+      logger.error(`Failed to restore ${brand.toLowerCase()}.json`, { error: err });
+      console.log(source_default.yellow(`  \u26A0 Failed to restore ${brand.toLowerCase()}.json, skipping...`));
     }
   }
   if (record.installedWorkerIds.length > 0) {
@@ -20483,15 +20618,17 @@ async function performRollback(recordId, clawDir) {
   spinner.succeed(
     `Rolled back ${source_default.cyan.bold(record.packageName)} successfully! (${restoredCount} item(s) restored)`
   );
-  const restartSpinner = createSpinner("Restarting OpenClaw Gateway...").start();
+  const clawCmd = detectClawCommand();
+  const brandName = clawCmd === "lightclaw" ? "LightClaw" : "OpenClaw";
+  const restartSpinner = createSpinner(`Restarting ${brandName} Gateway...`).start();
   const result = restartOpenClawGateway();
   if (result.success) {
-    restartSpinner.succeed("OpenClaw Gateway restarted successfully.");
+    restartSpinner.succeed(`${brandName} Gateway restarted successfully.`);
   } else {
-    restartSpinner.warn("Failed to restart OpenClaw Gateway.");
+    restartSpinner.warn(`Failed to restart ${brandName} Gateway.`);
     console.log(source_default.yellow(`  Reason: ${result.message}`));
     console.log(source_default.dim("  Please restart manually:"));
-    console.log(source_default.dim("    openclaw gateway restart"));
+    console.log(source_default.dim(`    ${clawCmd} gateway restart`));
   }
   console.log();
 }
@@ -20512,13 +20649,13 @@ function formatInstallType(type2) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("soulhub").description("SoulHub CLI - Install and manage AI agent persona templates").version("1.0.12").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
+program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.14").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
   const opts = program2.opts();
   const verbose = opts.verbose || process.env.SOULHUB_DEBUG === "1";
   logger.init(verbose);
   logger.info("CLI started", {
     args: process.argv.slice(2),
-    version: "1.0.12",
+    version: "1.0.14",
     node: process.version
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulhubcli",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "SoulHub CLI - Install and manage AI agent persona templates for OpenClaw",
   "type": "module",
   "bin": {