soulhubcli 1.0.18 → 1.0.20

package/README.md

@@ -90,8 +90,8 @@ soulhub install --from https://example.com/agent-team.zip
 # 安装到自定义目录（不依赖 OpenClaw/LightClaw 环境）
 soulhub install writer-wechat --dir ./my-agents
 
-# 指定 claw 安装目录（只安装到该 claw）
-soulhub install writer-wechat --claw-dir ~/.lightclaw
+# 指定 claw 类型（只安装到该 claw）
+soulhub install writer-wechat --clawtype LightClaw
 ```
 
 ### 列出已安装的 Agent
@@ -119,7 +119,7 @@ soulhub uninstall ops-assistant
 
 - **默认安装为 Worker Agent**（子 agent），部署到 `workspace-<agentId>/` 目录
 - 使用 `--main` 参数可安装为主 Agent，部署到 `workspace/` 目录
-- **自动安装到所有检测到的 claw 目录**（OpenClaw / LightClaw），使用 `--claw-dir` 可指定单个 claw
+- **自动安装到所有检测到的 claw 目录**（OpenClaw / LightClaw），使用 `--clawtype` 可指定单个 claw
 - 如果目标目录已存在，CLI 会**自动备份**（复制到 `agentbackup/`）
 - 仅覆盖 `IDENTITY.md`、`SOUL.md` 等灵魂文件，不影响 workspace 中的其他运行时文件
 - 安装完成后自动重启 OpenClaw Gateway；若重启失败会提示手动重启
@@ -148,11 +148,11 @@ export SOULHUB_REGISTRY_URL=https://your-registry.example.com
 
 CLI 按以下优先级查找 claw 安装目录：
 
-1. `--claw-dir` 命令行参数（指定时只安装到该 claw）
+1. `--clawtype` 命令行参数（指定时只安装到该 claw）
 2. `OPENCLAW_HOME` / `LIGHTCLAW_HOME` 环境变量
 3. 默认路径 `~/.openclaw`、`~/.lightclaw`
 
-未指定 `--claw-dir` 时，CLI 会检测所有可用的 claw 目录并全部安装。
+未指定 `--clawtype` 时，CLI 会检测所有可用的 claw 目录并全部安装。
 
 ## 环境要求
 

package/dist/index.cjs

@@ -19033,11 +19033,15 @@ function copyAgentFilesFromPackage(packageDir, targetDir) {
 }
 function findOpenClawDir(customDir) {
   if (customDir) {
-    const resolved = import_node_path11.default.resolve(customDir);
-    if (import_node_fs8.default.existsSync(resolved)) {
-      return resolved;
+    const home2 = import_node_os2.default.homedir();
+    const lower = customDir.toLowerCase();
+    if (lower === "openclaw") {
+      return import_node_path11.default.join(home2, ".openclaw");
     }
-    return resolved;
+    if (lower === "lightclaw") {
+      return import_node_path11.default.join(home2, ".lightclaw");
+    }
+    throw new Error(`Unsupported claw type: "${customDir}". Only "OpenClaw" or "LightClaw" is supported (case-insensitive).`);
   }
   const envHome = process.env.OPENCLAW_HOME || process.env.LIGHTCLAW_HOME;
   if (envHome) {
@@ -19063,8 +19067,15 @@ function findOpenClawDir(customDir) {
 }
 function findAllClawDirs(customDir) {
   if (customDir) {
-    const resolved = import_node_path11.default.resolve(customDir);
-    return import_node_fs8.default.existsSync(resolved) ? [resolved] : [resolved];
+    const home2 = import_node_os2.default.homedir();
+    const lower = customDir.toLowerCase();
+    if (lower === "openclaw") {
+      return [import_node_path11.default.join(home2, ".openclaw")];
+    }
+    if (lower === "lightclaw") {
+      return [import_node_path11.default.join(home2, ".lightclaw")];
+    }
+    throw new Error(`Unsupported claw type: "${customDir}". Only "OpenClaw" or "LightClaw" is supported (case-insensitive).`);
   }
   const envHome = process.env.OPENCLAW_HOME || process.env.LIGHTCLAW_HOME;
   if (envHome) {
@@ -19207,9 +19218,10 @@ function writeOpenClawConfig(clawDir, config) {
   import_node_fs8.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
 }
 function updateOpenClawConfig(clawDir, updater) {
-  const config = readOpenClawConfig(clawDir);
+  let config = readOpenClawConfig(clawDir);
   if (!config) {
-    return false;
+    logger.info(`Config file not found in ${clawDir}, creating default config.`);
+    config = { agents: { list: [] } };
   }
   const updated = updater(config);
   writeOpenClawConfig(clawDir, updated);
@@ -19765,15 +19777,15 @@ var installCommand = new Command("install").description("Install an agent or tea
   "--dir <path>",
   "Target directory (defaults to OpenClaw/LightClaw workspace)"
 ).option(
-  "--claw-dir <path>",
-  "OpenClaw/LightClaw installation directory (overrides OPENCLAW_HOME/LIGHTCLAW_HOME env var, defaults to ~/.openclaw or ~/.lightclaw)"
+  "--clawtype <type>",
+  "Specify claw type: OpenClaw or LightClaw (case-insensitive)"
 ).action(async (name, options) => {
   try {
     const asMain = !!options.main;
     if (options.from) {
-      await installFromSource(options.from, options.dir, options.clawDir, asMain);
+      await installFromSource(options.from, options.dir, options.clawtype, asMain);
     } else if (name) {
-      await installFromRegistry(name, options.dir, options.clawDir, asMain);
+      await installFromRegistry(name, options.dir, options.clawtype, 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:"));
@@ -19781,7 +19793,7 @@ var installCommand = new Command("install").description("Install an agent or tea
       console.log(source_default.dim("    soulhub install writer-wechat --main     # Install as main agent"));
       console.log(source_default.dim("    soulhub install dev-squad                # Install a team from registry"));
       console.log(source_default.dim("    soulhub install --from ./agent-team/     # Install from local directory"));
-      console.log(source_default.dim("    soulhub install writer-wechat --claw-dir ~/.lightclaw  # Install to specific claw"));
+      console.log(source_default.dim("    soulhub install writer-wechat --clawtype LightClaw  # Install to specific claw"));
       process.exit(1);
     }
   } catch (error) {
@@ -19834,7 +19846,13 @@ async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
   spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
   const pkgDir = await downloadAgentPackage(name, agent.version);
   spinner.succeed(`Package ${source_default.cyan(agent.displayName)} downloaded.`);
+  const showClawHeader = allClawDirs.length > 1;
   for (const selectedClawDir of allClawDirs) {
+    if (showClawHeader) {
+      const brand = detectClawBrand(selectedClawDir);
+      console.log();
+      console.log(source_default.bold(`\u2500\u2500 ${brand} (${selectedClawDir}) \u2500\u2500`));
+    }
     await installSingleAgentToClaw(name, selectedClawDir, void 0, asMain, pkgDir, agent);
   }
   import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
@@ -20120,7 +20138,13 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain
     printOpenClawInstallHelp();
     return;
   }
+  const showClawHeader = allClawDirs.length > 1;
   for (const selectedClawDir of allClawDirs) {
+    if (showClawHeader) {
+      const brand = detectClawBrand(selectedClawDir);
+      console.log();
+      console.log(source_default.bold(`\u2500\u2500 ${brand} (${selectedClawDir}) \u2500\u2500`));
+    }
     await installSingleAgentFromDirToClaw(packageDir, agentName, pkg, selectedClawDir, void 0, asMain);
   }
 }
@@ -20389,7 +20413,7 @@ async function extractZipToDir(zip, targetDir) {
 }
 function printOpenClawInstallHelp() {
   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("  --clawtype <type>            Specify claw type: OpenClaw or LightClaw"));
   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)"));
@@ -20522,16 +20546,16 @@ var updateCommand = new Command("update").description("Update installed agents t
 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/LightClaw installation directory (overrides OPENCLAW_HOME/LIGHTCLAW_HOME env var)"
+  "--clawtype <type>",
+  "Specify claw type: OpenClaw or LightClaw (case-insensitive)"
 ).action(async (options) => {
   try {
     if (options.list) {
       listBackupRecords();
     } else if (options.id) {
-      await performRollback(options.id, options.clawDir);
+      await performRollback(options.id, options.clawtype);
     } else {
-      await performRollback(void 0, options.clawDir);
+      await performRollback(void 0, options.clawtype);
     }
   } catch (error) {
     logger.errorObj("Rollback command failed", error);
@@ -20703,13 +20727,13 @@ function formatInstallType(type2) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.18").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
+program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.20").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.18",
+    version: "1.0.20",
     node: process.version
   });
 });

package/package.json

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