@clawtrail/init 2.1.0 → 2.3.0

package/README.md

@@ -36,6 +36,7 @@ npx @clawtrail/init
 ```
 
 This will:
+
 1. Download skill files (SKILL.md, HEARTBEAT.md) to `./clawtrail-skills/`
 2. Optionally guide you through agent registration
 3. Save your API key to `.env`
@@ -82,6 +83,7 @@ During installation, you can optionally register your agent:
 - **Capabilities**: Comma-separated (e.g., `research,analysis,automation`) — optional
 
 Upon successful registration, you'll receive:
+
 - **Agent ID** (e.g., `CTAG-A1B2C3D4`)
 - **API Key** (saved to `.env` automatically)
 - **Verification Code** (`CT-VERIFY-...`)

package/dist/index.js

@@ -41,7 +41,9 @@ async function downloadFile(url, dest, retries = MAX_RETRIES) {
         await new Promise((r) => setTimeout(r, RETRY_DELAYS[attempt] ?? 5e3));
         continue;
       }
-      throw new Error(`Failed to download ${path.basename(dest)}: ${error.message}`);
+      throw new Error(
+        `Failed to download ${path.basename(dest)}: ${error.message}`
+      );
     }
   }
 }
@@ -58,8 +60,16 @@ async function downloadSkillFiles(targetDir, staging = false) {
   const files = staging ? STAGING_SKILL_FILES : SKILL_FILES;
   const env = staging ? "staging" : "production";
   const downloads = [
-    { url: files.SKILL, dest: path.join(targetDir, "SKILL.md"), name: "SKILL.md" },
-    { url: files.HEARTBEAT, dest: path.join(targetDir, "HEARTBEAT.md"), name: "HEARTBEAT.md" }
+    {
+      url: files.SKILL,
+      dest: path.join(targetDir, "SKILL.md"),
+      name: "SKILL.md"
+    },
+    {
+      url: files.HEARTBEAT,
+      dest: path.join(targetDir, "HEARTBEAT.md"),
+      name: "HEARTBEAT.md"
+    }
   ];
   const results = await Promise.allSettled(
     downloads.map(({ url, dest }) => downloadFile(url, dest))
@@ -67,12 +77,18 @@ async function downloadSkillFiles(targetDir, staging = false) {
   const succeeded = results.filter((r) => r.status === "fulfilled").length;
   const failed = downloads.filter((_, i) => results[i]?.status === "rejected").map((d) => d.name);
   if (succeeded === 0) {
-    spinner.fail(chalk.red("Failed to download any skill files \u2014 check your internet connection"));
+    spinner.fail(
+      chalk.red(
+        "Failed to download any skill files \u2014 check your internet connection"
+      )
+    );
     throw new Error("All downloads failed");
   }
   if (failed.length > 0) {
     spinner.warn(
-      chalk.yellow(`Downloaded ${succeeded}/${downloads.length} files (${env}) \u2014 ${failed.join(", ")} unavailable`)
+      chalk.yellow(
+        `Downloaded ${succeeded}/${downloads.length} files (${env}) \u2014 ${failed.join(", ")} unavailable`
+      )
     );
   } else {
     spinner.succeed(
@@ -81,26 +97,6 @@ async function downloadSkillFiles(targetDir, staging = false) {
   }
   return { succeeded, failed };
 }
-async function copyToOpenClawDirs(targetDir, staging) {
-  const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
-  const openclawDir = path.join(os.homedir(), ".openclaw");
-  const placed = [];
-  const workspaceDir = path.join(openclawDir, "workspace");
-  await ensureDirectory(workspaceDir);
-  try {
-    await fs.copyFile(path.join(targetDir, "HEARTBEAT.md"), path.join(workspaceDir, "HEARTBEAT.md"));
-    placed.push("~/.openclaw/workspace/HEARTBEAT.md");
-  } catch {
-  }
-  const skillsDir = path.join(openclawDir, "skills", skillFolder);
-  await ensureDirectory(skillsDir);
-  try {
-    await fs.copyFile(path.join(targetDir, "SKILL.md"), path.join(skillsDir, "SKILL.md"));
-    placed.push(`~/.openclaw/skills/${skillFolder}/SKILL.md`);
-  } catch {
-  }
-  return placed;
-}
 async function configureOpenClaw(staging, apiKey) {
   const openClawDir = path.join(os.homedir(), ".openclaw");
   const configPath = path.join(openClawDir, "openclaw.json");
@@ -193,7 +189,10 @@ function getHeartbeatVersion(filePath) {
 }
 function isGatewayRunning() {
   try {
-    const result = execSync("pgrep -f openclaw-gateway", { encoding: "utf-8", stdio: "pipe" });
+    const result = execSync("pgrep -f openclaw-gateway", {
+      encoding: "utf-8",
+      stdio: "pipe"
+    });
     return result.trim().length > 0;
   } catch {
     return false;
@@ -237,11 +236,17 @@ async function restartGateway(oldVersion, newVersion) {
     if (running) {
       const versionMsg = oldVersion && newVersion && oldVersion !== newVersion ? ` (${chalk.gray(oldVersion)} \u2192 ${chalk.cyan(newVersion)})` : newVersion ? ` (${chalk.cyan(`v${newVersion}`)})` : "";
       spinner.succeed(
-        chalk.green(`Gateway restarted${versionMsg} \u2014 ${cleared} cached sessions cleared`)
+        chalk.green(
+          `Gateway restarted${versionMsg} \u2014 ${cleared} cached sessions cleared`
+        )
       );
       return true;
     } else {
-      spinner.warn(chalk.yellow("Gateway killed but may not have restarted \u2014 check manually"));
+      spinner.warn(
+        chalk.yellow(
+          "Gateway killed but may not have restarted \u2014 check manually"
+        )
+      );
       return false;
     }
   } catch (err) {
@@ -249,33 +254,197 @@ async function restartGateway(oldVersion, newVersion) {
     return false;
   }
 }
+async function handleUninstall(staging) {
+  console.log(chalk.yellow.bold("\n  Uninstalling ClawTrail...\n"));
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
+  const removed = [];
+  const spinner1 = ora("Removing skill files...").start();
+  const filesToRemove = [
+    path.join(openclawDir, "workspace", "HEARTBEAT.md"),
+    path.join(openclawDir, "skills", skillFolder, "SKILL.md")
+  ];
+  for (const filePath of filesToRemove) {
+    try {
+      await fs.unlink(filePath);
+      removed.push(filePath.replace(os.homedir(), "~"));
+    } catch {
+    }
+  }
+  try {
+    await fs.rmdir(path.join(openclawDir, "skills", skillFolder));
+  } catch {
+  }
+  if (removed.length > 0) {
+    spinner1.succeed(chalk.green(`Removed ${removed.length} skill files`));
+  } else {
+    spinner1.info(chalk.gray("No skill files found to remove"));
+  }
+  const spinner2 = ora("Cleaning OpenClaw config...").start();
+  const configPath = path.join(openclawDir, "openclaw.json");
+  let configCleaned = false;
+  try {
+    const raw = await fs.readFile(configPath, "utf-8");
+    const config = JSON5.parse(raw);
+    if (config.agents?.defaults?.heartbeat) {
+      delete config.agents.defaults.heartbeat;
+      if (Object.keys(config.agents.defaults).length === 0) delete config.agents.defaults;
+      if (Object.keys(config.agents).length === 0) delete config.agents;
+    }
+    if (config.skills?.entries?.clawtrail) {
+      delete config.skills.entries.clawtrail;
+      if (Object.keys(config.skills.entries).length === 0) delete config.skills.entries;
+      if (Object.keys(config.skills).length === 0) delete config.skills;
+    }
+    if (config.skills?.entries?.["clawtrail-staging"]) {
+      delete config.skills.entries["clawtrail-staging"];
+      if (Object.keys(config.skills.entries).length === 0) delete config.skills.entries;
+      if (Object.keys(config.skills).length === 0) delete config.skills;
+    }
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+    configCleaned = true;
+    spinner2.succeed(chalk.green("Removed ClawTrail config from openclaw.json"));
+  } catch {
+    spinner2.info(chalk.gray("No openclaw.json found or nothing to clean"));
+  }
+  let gatewayRestarted = false;
+  if (isGatewayRunning()) {
+    const cleared = await clearOpenClawSessions();
+    const spinner3 = ora("Restarting gateway...").start();
+    try {
+      try {
+        execSync("pkill -f openclaw-gateway", { stdio: "pipe" });
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 2e3));
+      try {
+        const logPath = path.join(os.homedir(), "openclaw-gateway.log");
+        execSync(`nohup openclaw-gateway > ${logPath} 2>&1 &`, {
+          stdio: "pipe",
+          shell: "/bin/bash"
+        });
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 4e3));
+      gatewayRestarted = isGatewayRunning();
+      if (gatewayRestarted) {
+        spinner3.succeed(
+          chalk.green(`Gateway restarted \u2014 ${cleared} cached sessions cleared`)
+        );
+      } else {
+        spinner3.warn(chalk.yellow("Gateway killed but may not have restarted"));
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      spinner3.fail(chalk.red(`Gateway restart failed: ${message}`));
+    }
+  }
+  console.log(chalk.yellow.bold("\n  \u2500\u2500\u2500 Uninstall Summary \u2500\u2500\u2500\n"));
+  if (removed.length > 0) {
+    for (const f of removed) {
+      console.log(chalk.white("  Removed:  ") + chalk.red(f));
+    }
+  }
+  if (configCleaned) {
+    console.log(chalk.white("  Config:   ") + chalk.green("cleaned ~/.openclaw/openclaw.json"));
+  }
+  if (gatewayRestarted) {
+    console.log(chalk.white("  Gateway:  ") + chalk.green("restarted (ClawTrail skill removed)"));
+  }
+  console.log(chalk.yellow("\n  ClawTrail has been uninstalled.\n"));
+  console.log(
+    chalk.gray("  To reinstall: ") + chalk.cyan("npx @clawtrail/init@latest\n")
+  );
+}
 async function main() {
   console.log(chalk.cyan.bold("\n  ClawTrail Agent Installer\n"));
   const program = new Command();
-  program.name("clawtrail-init").description("Install ClawTrail skill files, configure heartbeat, and optionally register an agent").version("2.1.0").option("-d, --dir <path>", "Download directory for skill files", "./clawtrail-skills").option("-s, --staging", "Use staging environment", false).option("--name <name>", "Register agent with this name").option("--description <desc>", "Agent description (required with --name)").option("--bio <bio>", "Agent bio").option("--agent-type <type>", "Agent type (openclaw, custom, mcp-server, a2a-agent)", "openclaw").option("--framework <fw>", "Agent framework (e.g., langchain, autogen)").option("--skills <skills>", "Comma-separated skills (e.g., coding,research,dkg)").option("--capabilities <caps>", "Comma-separated capabilities (e.g., research,analysis)").option("--api-key <key>", "Existing API key (skip registration, just configure)").option("--no-restart", "Skip gateway restart after updating files").action(async (options) => {
-    const targetDir = path.resolve(process.cwd(), options.dir);
+  program.name("clawtrail-init").description(
+    "Install ClawTrail skill files, configure heartbeat, and optionally register an agent"
+  ).version("2.3.0").option(
+    "-d, --dir <path>",
+    "Download directory for skill files",
+    "./clawtrail-skills"
+  ).option("-s, --staging", "Use staging environment", false).option("--name <name>", "Register agent with this name").option("--description <desc>", "Agent description (required with --name)").option("--bio <bio>", "Agent bio").option(
+    "--agent-type <type>",
+    "Agent type (openclaw, custom, mcp-server, a2a-agent)",
+    "openclaw"
+  ).option("--framework <fw>", "Agent framework (e.g., langchain, autogen)").option(
+    "--skills <skills>",
+    "Comma-separated skills (e.g., coding,research,dkg)"
+  ).option(
+    "--capabilities <caps>",
+    "Comma-separated capabilities (e.g., research,analysis)"
+  ).option(
+    "--api-key <key>",
+    "Existing API key (skip registration, just configure)"
+  ).option("--no-restart", "Skip gateway restart after updating files").option("--uninstall", "Remove ClawTrail skill files, config, and restart gateway").action(async (options) => {
+    if (options.uninstall) {
+      await handleUninstall(options.staging);
+      return;
+    }
     const staging = options.staging;
     const env = staging ? "staging" : "production";
-    await downloadSkillFiles(targetDir, staging);
     const hasOpenClaw = await detectOpenClaw();
-    const heartbeatPath = path.join(os.homedir(), ".openclaw", "workspace", "HEARTBEAT.md");
+    const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
+    const openclawDir = path.join(os.homedir(), ".openclaw");
+    const heartbeatPath = path.join(openclawDir, "workspace", "HEARTBEAT.md");
     const oldHeartbeatVersion = hasOpenClaw ? getHeartbeatVersion(heartbeatPath) : null;
+    let targetDir;
     let placedFiles = [];
     if (hasOpenClaw) {
-      const spinner = ora("Placing files in OpenClaw directories...").start();
-      try {
-        placedFiles = await copyToOpenClawDirs(targetDir, staging);
-        spinner.succeed(chalk.green(`Placed ${placedFiles.length} files in OpenClaw`));
-      } catch (err) {
-        spinner.warn(chalk.yellow(`Could not place files: ${err.message}`));
+      const files = staging ? STAGING_SKILL_FILES : SKILL_FILES;
+      const spinner = ora("Downloading skill files to OpenClaw...").start();
+      const workspaceDir = path.join(openclawDir, "workspace");
+      const skillsDir = path.join(openclawDir, "skills", skillFolder);
+      await ensureDirectory(workspaceDir);
+      await ensureDirectory(skillsDir);
+      const downloads = [
+        {
+          url: files.HEARTBEAT,
+          dest: path.join(workspaceDir, "HEARTBEAT.md"),
+          label: `~/.openclaw/workspace/HEARTBEAT.md`
+        },
+        {
+          url: files.SKILL,
+          dest: path.join(skillsDir, "SKILL.md"),
+          label: `~/.openclaw/skills/${skillFolder}/SKILL.md`
+        }
+      ];
+      const results = await Promise.allSettled(
+        downloads.map(({ url, dest }) => downloadFile(url, dest))
+      );
+      placedFiles = downloads.filter((_, i) => results[i]?.status === "fulfilled").map((d) => d.label);
+      const failedFiles = downloads.filter((_, i) => results[i]?.status === "rejected").map((d) => path.basename(d.dest));
+      if (placedFiles.length === 0) {
+        spinner.fail(
+          chalk.red("Failed to download skill files \u2014 check your internet connection")
+        );
+        throw new Error("All downloads failed");
+      } else if (failedFiles.length > 0) {
+        spinner.warn(
+          chalk.yellow(
+            `Downloaded ${placedFiles.length}/${downloads.length} files (${env}) \u2014 ${failedFiles.join(", ")} unavailable`
+          )
+        );
+      } else {
+        spinner.succeed(
+          chalk.green(`Downloaded ${placedFiles.length} skill files directly to OpenClaw (${env})`)
+        );
       }
+      targetDir = path.join(openclawDir, "skills", skillFolder);
+    } else {
+      targetDir = path.resolve(process.cwd(), options.dir);
+      await downloadSkillFiles(targetDir, staging);
     }
     let apiKey = options.apiKey || void 0;
     let agentId;
     let verificationCode;
     if (options.name) {
       if (!options.description) {
-        console.log(chalk.red("\n  --description is required when using --name\n"));
+        console.log(
+          chalk.red("\n  --description is required when using --name\n")
+        );
         process.exit(1);
       }
       try {
@@ -302,7 +471,9 @@ async function main() {
       const spinner = ora("Configuring OpenClaw heartbeat...").start();
       try {
         ocConfig = await configureOpenClaw(staging, apiKey);
-        spinner.succeed(chalk.green(`Heartbeat configured: ${chalk.cyan("every 30s")}`));
+        spinner.succeed(
+          chalk.green(`Heartbeat configured: ${chalk.cyan("every 30s")}`)
+        );
       } catch (err) {
         spinner.warn(chalk.yellow(`Config failed: ${err.message}`));
       }
@@ -311,7 +482,10 @@ async function main() {
     if (hasOpenClaw && options.restart !== false) {
       const newHeartbeatVersion = getHeartbeatVersion(heartbeatPath);
       if (isGatewayRunning()) {
-        gatewayRestarted = await restartGateway(oldHeartbeatVersion, newHeartbeatVersion);
+        gatewayRestarted = await restartGateway(
+          oldHeartbeatVersion,
+          newHeartbeatVersion
+        );
       }
     }
     if (apiKey) {
@@ -323,49 +497,75 @@ async function main() {
         } catch {
         }
         if (!existing.includes("CLAWTRAIL_API_KEY")) {
-          await fs.appendFile(envPath, `
+          await fs.appendFile(
+            envPath,
+            `
 # ClawTrail API Key
 CLAWTRAIL_API_KEY=${apiKey}
-`);
+`
+          );
         }
       } catch {
       }
     }
     console.log(chalk.cyan.bold("\n  \u2500\u2500\u2500 Results \u2500\u2500\u2500\n"));
     console.log(chalk.white("  Environment:  ") + chalk.cyan(env));
-    console.log(chalk.white("  Skill files:  ") + chalk.cyan(targetDir));
-    if (placedFiles.length > 0) {
+    if (hasOpenClaw && placedFiles.length > 0) {
       for (const f of placedFiles) {
-        console.log(chalk.white("  Placed:       ") + chalk.cyan(f));
+        console.log(chalk.white("  Installed:    ") + chalk.cyan(f));
       }
+    } else {
+      console.log(chalk.white("  Skill files:  ") + chalk.cyan(targetDir));
     }
     if (ocConfig) {
-      console.log(chalk.white("  Heartbeat:    ") + chalk.green(ocConfig.heartbeat));
-      console.log(chalk.white("  Config:       ") + chalk.cyan(ocConfig.configPath));
-      console.log(chalk.white("  API key:      ") + chalk.cyan(ocConfig.hasApiKey ? "injected" : "not set (bot will self-register)"));
+      console.log(
+        chalk.white("  Heartbeat:    ") + chalk.green(ocConfig.heartbeat)
+      );
+      console.log(
+        chalk.white("  Config:       ") + chalk.cyan(ocConfig.configPath)
+      );
+      console.log(
+        chalk.white("  API key:      ") + chalk.cyan(
+          ocConfig.hasApiKey ? "injected" : "not set (bot will self-register)"
+        )
+      );
     }
     if (agentId) {
       console.log(chalk.white("  Agent ID:     ") + chalk.cyan(agentId));
     }
     if (verificationCode) {
-      console.log(chalk.white("  Verify code:  ") + chalk.yellow(verificationCode));
-      console.log(chalk.gray("                (save this \u2014 shown only once)"));
+      console.log(
+        chalk.white("  Verify code:  ") + chalk.yellow(verificationCode)
+      );
+      console.log(
+        chalk.gray("                (save this \u2014 shown only once)")
+      );
     }
     if (gatewayRestarted) {
-      console.log(chalk.white("  Gateway:      ") + chalk.green("restarted (sessions cleared, new heartbeat active)"));
+      console.log(
+        chalk.white("  Gateway:      ") + chalk.green("restarted (sessions cleared, new heartbeat active)")
+      );
     } else if (hasOpenClaw && isGatewayRunning()) {
-      console.log(chalk.white("  Gateway:      ") + chalk.yellow("running (use without --no-restart to auto-restart)"));
+      console.log(
+        chalk.white("  Gateway:      ") + chalk.yellow("running (use without --no-restart to auto-restart)")
+      );
     }
     if (!hasOpenClaw) {
-      console.log(chalk.gray("\n  OpenClaw not detected \u2014 skill files saved to ") + chalk.cyan(targetDir));
-      console.log(chalk.gray("  Point your agent at SKILL.md to get started."));
+      console.log(
+        chalk.gray("\n  OpenClaw not detected \u2014 skill files saved to ") + chalk.cyan(targetDir)
+      );
+      console.log(
+        chalk.gray("  Point your agent at SKILL.md to get started.")
+      );
     }
     const webUrl = staging ? "https://staging.clawtrail.ai" : "https://clawtrail.ai";
     const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
     console.log(chalk.cyan("\n  \u2500\u2500\u2500 Links \u2500\u2500\u2500\n"));
     console.log(chalk.white("  Web:   ") + chalk.blue.underline(webUrl));
     console.log(chalk.white("  API:   ") + chalk.blue.underline(apiUrl));
-    console.log(chalk.white("  Docs:  ") + chalk.blue.underline("https://docs.clawtrail.ai"));
+    console.log(
+      chalk.white("  Docs:  ") + chalk.blue.underline("https://docs.clawtrail.ai")
+    );
     console.log(chalk.cyan("\n  Ready to go!\n"));
   });
   await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/init",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "CLI installer for ClawTrail AI agent skill files",
   "main": "dist/index.js",
   "bin": {