nextclaw 0.16.20 → 0.16.22

package/dist/cli/index.js

@@ -10,7 +10,7 @@ import {
   loadConfig as loadConfig21,
   saveConfig as saveConfig11,
   getConfigPath as getConfigPath11,
-  getDataDir as getDataDir10,
+  getDataDir as getDataDir11,
   getWorkspacePath as getWorkspacePath13,
   expandHome as expandHome2,
   MessageBus as MessageBus3,
@@ -28,7 +28,7 @@ import {
   setPluginRuntimeBridge as setPluginRuntimeBridge3
 } from "@nextclaw/openclaw-compat";
 import { existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "fs";
-import { join as join9, resolve as resolve14 } from "path";
+import { join as join9, resolve as resolve15 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { spawn as spawn4 } from "child_process";
@@ -456,8 +456,8 @@ function isRecord(value) {
 var MARKETPLACE_NETWORK_RETRY_ATTEMPTS = 5;
 var MARKETPLACE_NETWORK_RETRY_BASE_MS = 350;
 function sleepMs(ms) {
-  return new Promise((resolve15) => {
-    setTimeout(resolve15, ms);
+  return new Promise((resolve16) => {
+    setTimeout(resolve16, ms);
   });
 }
 function isRetryableMarketplaceNetworkError(error) {
@@ -853,6 +853,7 @@ function isRecord2(value) {
 // src/cli/update/runner.ts
 import { spawnSync } from "child_process";
 import { resolve as resolve5 } from "path";
+import { createExternalCommandEnv as createExternalCommandEnv2 } from "@nextclaw/core";
 
 // src/cli/utils.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, rmSync as rmSync3 } from "fs";
@@ -860,7 +861,11 @@ import { join as join2, resolve as resolve4 } from "path";
 import { spawn } from "child_process";
 import { isIP } from "net";
 import { fileURLToPath } from "url";
-import { getDataDir as getDataDir2, getPackageVersion as getCorePackageVersion } from "@nextclaw/core";
+import {
+  createExternalCommandEnv,
+  getDataDir as getDataDir2,
+  getPackageVersion as getCorePackageVersion
+} from "@nextclaw/core";
 function resolveUiConfig(config2, overrides) {
   const base = config2.ui ?? { enabled: false, host: "127.0.0.1", port: 55667, open: false };
   return { ...base, ...overrides ?? {} };
@@ -960,7 +965,7 @@ async function waitForExit(pid, timeoutMs) {
     if (!isProcessRunning(pid)) {
       return true;
     }
-    await new Promise((resolve15) => setTimeout(resolve15, 200));
+    await new Promise((resolve16) => setTimeout(resolve16, 200));
   }
   return !isProcessRunning(pid);
 }
@@ -991,7 +996,11 @@ function openBrowser(url) {
     command = "xdg-open";
     args = [url];
   }
-  const child = spawn(command, args, { stdio: "ignore", detached: true });
+  const child = spawn(command, args, {
+    stdio: "ignore",
+    detached: true,
+    env: createExternalCommandEnv(process.env)
+  });
   child.unref();
 }
 function normalizePathEntries(rawPath, platform) {
@@ -1087,8 +1096,8 @@ function printAgentResponse(response) {
 async function prompt(rl, question) {
   rl.setPrompt(question);
   rl.prompt();
-  return new Promise((resolve15) => {
-    rl.once("line", (line) => resolve15(line));
+  return new Promise((resolve16) => {
+    rl.once("line", (line) => resolve16(line));
   });
 }
 
@@ -1108,6 +1117,7 @@ function runSelfUpdate(options = {}) {
   const runStep = (cmd, args, cwd) => {
     const result = spawnSync(cmd, args, {
       cwd,
+      env: createExternalCommandEnv2(process.env),
       encoding: "utf-8",
       timeout: timeoutMs,
       stdio: "pipe"
@@ -1888,8 +1898,8 @@ var PluginCommands = class {
       input: process.stdin,
       output: process.stdout
     });
-    const answer = await new Promise((resolve15) => {
-      rl.question(`${question} [y/N] `, (line) => resolve15(line));
+    const answer = await new Promise((resolve16) => {
+      rl.question(`${question} [y/N] `, (line) => resolve16(line));
     });
     rl.close();
     const normalized = answer.trim().toLowerCase();
@@ -3066,7 +3076,7 @@ function printCronJobs(jobs) {
     return;
   }
   for (const job of jobs) {
-    console.log(`${job.id} ${job.name} ${formatCronSchedule(job.schedule)}`);
+    console.log(`${job.id} [${job.enabled ? "enabled" : "disabled"}] ${job.name} ${formatCronSchedule(job.schedule)}`);
   }
 }
 
@@ -3142,10 +3152,11 @@ var CronCommands = class {
     return new UiBridgeApiClient(apiBase);
   };
   cronList = async (opts) => {
+    const includeDisabled = opts.enabledOnly !== true;
     const apiClient = this.createApiClient();
     if (apiClient) {
       try {
-        const query = opts.all ? "?all=1" : "";
+        const query = includeDisabled ? "" : "?enabledOnly=1";
         const data = await apiClient.request({
           path: `/api/cron${query}`
         });
@@ -3154,7 +3165,7 @@ var CronCommands = class {
       } catch {
       }
     }
-    printCronJobs(this.local.list(Boolean(opts.all)));
+    printCronJobs(this.local.list(includeDisabled));
   };
   cronAdd = async (opts) => {
     const result = this.local.add(opts);
@@ -4172,17 +4183,17 @@ var DiagnosticsCommands = class {
     }
   }
   async checkPortAvailability(params) {
-    return await new Promise((resolve15) => {
+    return await new Promise((resolve16) => {
       const server = createNetServer();
       server.once("error", (error) => {
-        resolve15({
+        resolve16({
           available: false,
           detail: `bind failed on ${params.host}:${params.port} (${String(error)})`
         });
       });
       server.listen(params.port, params.host, () => {
         server.close(() => {
-          resolve15({
+          resolve16({
             available: true,
             detail: `bind ok on ${params.host}:${params.port}`
           });
@@ -4200,13 +4211,13 @@ import {
   stopPluginChannelGateways as stopPluginChannelGateways2
 } from "@nextclaw/openclaw-compat";
 import { appendFileSync, closeSync as closeSync2, cpSync as cpSync2, existsSync as existsSync11, mkdirSync as mkdirSync5, openSync as openSync2 } from "fs";
-import { dirname as dirname3, join as join7, resolve as resolve12 } from "path";
+import { dirname as dirname3, join as join7, resolve as resolve13 } from "path";
 import { spawn as spawn3 } from "child_process";
 import { request as httpRequest } from "http";
 import { request as httpsRequest } from "https";
 import { createServer as createNetServer2 } from "net";
 import { setImmediate as waitForNextTick } from "timers/promises";
-import chokidar from "chokidar";
+import chokidar2 from "chokidar";
 
 // src/cli/missing-provider.ts
 import { LLMProvider } from "@nextclaw/core";
@@ -4461,6 +4472,8 @@ var ServiceMarketplaceInstaller = class {
 };
 
 // src/cli/commands/service-startup-support.ts
+import chokidar from "chokidar";
+import { resolve as resolve9 } from "path";
 var pluginGatewayLogger = {
   info: (message) => console.log(`[plugins] ${message}`),
   warn: (message) => console.warn(`[plugins] ${message}`),
@@ -4488,16 +4501,35 @@ async function startGatewaySupportServices(params) {
   await params.startCron();
   await params.startHeartbeat();
 }
+function watchCronStoreFile(params) {
+  const cronStorePath = resolve9(params.cronStorePath);
+  const watcher = chokidar.watch(cronStorePath, {
+    ignoreInitial: true,
+    awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }
+  });
+  watcher.on("all", (event, changedPath) => {
+    if (resolve9(changedPath) !== cronStorePath) {
+      return;
+    }
+    if (event === "add" || event === "change" || event === "unlink") {
+      try {
+        params.reloadCronStore();
+      } catch (error) {
+        console.error(`Cron store reload failed (${event}): ${String(error)}`);
+      }
+    }
+  });
+}
 
 // src/cli/commands/cli-subcommand-launch.ts
 import { createRequire } from "module";
-import { extname, resolve as resolve9 } from "path";
+import { extname, resolve as resolve10 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var require2 = createRequire(import.meta.url);
 var resolveCliSubcommandEntry = (params) => {
   const argvEntry = params.argvEntry?.trim();
   if (argvEntry) {
-    return resolve9(argvEntry);
+    return resolve10(argvEntry);
   }
   return fileURLToPath3(new URL("../index.js", params.importMetaUrl));
 };
@@ -4514,10 +4546,10 @@ import {
   unlinkSync,
   writeFileSync as writeFileSync4
 } from "fs";
-import { dirname as dirname2, resolve as resolve10 } from "path";
+import { dirname as dirname2, resolve as resolve11 } from "path";
 import { getDataDir as getDataDir6 } from "@nextclaw/core";
 function resolveRemoteOwnershipLockPath() {
-  return resolve10(getDataDir6(), "run", "remote-owner.lock.json");
+  return resolve11(getDataDir6(), "run", "remote-owner.lock.json");
 }
 function readRemoteOwnershipRecord(lockPath) {
   try {
@@ -5051,7 +5083,7 @@ import {
 } from "@nextclaw/ncp-toolkit";
 
 // src/cli/commands/ncp/ncp-asset-tools.ts
-import { resolve as resolve11 } from "path";
+import { resolve as resolve12 } from "path";
 import {
   buildAssetContentPath
 } from "@nextclaw/ncp-agent-runtime";
@@ -5167,7 +5199,7 @@ var AssetExportTool = class {
     if (!assetUri || !targetPath) {
       throw new Error("asset_export requires assetUri and targetPath.");
     }
-    const exportedPath = await this.assetStore.export({ uri: assetUri }, resolve11(targetPath));
+    const exportedPath = await this.assetStore.export({ uri: assetUri }, resolve12(targetPath));
     return {
       ok: true,
       assetUri,
@@ -9040,6 +9072,7 @@ var ServiceCommands = class {
         startHeartbeat: () => gateway.heartbeat.start()
       })
     );
+    watchCronStoreFile({ cronStorePath: resolve13(join7(NextclawCore3.getDataDir(), "cron", "jobs.json")), reloadCronStore: () => gateway.cron.reloadFromStore() });
     const deferredGatewayStartupHooks = createDeferredGatewayStartupHooks({
       uiStartup,
       gateway,
@@ -9105,13 +9138,13 @@ var ServiceCommands = class {
     return trimmed || void 0;
   }
   watchConfigFile(reloader) {
-    const configPath = resolve12(getConfigPath10());
-    const watcher = chokidar.watch(configPath, {
+    const configPath = resolve13(getConfigPath10());
+    const watcher = chokidar2.watch(configPath, {
       ignoreInitial: true,
       awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }
     });
     watcher.on("all", (event, changedPath) => {
-      if (resolve12(changedPath) !== configPath) {
+      if (resolve13(changedPath) !== configPath) {
         return;
       }
       if (event === "add") {
@@ -9180,7 +9213,7 @@ var ServiceCommands = class {
     if (!sentinel) {
       return;
     }
-    await new Promise((resolve15) => setTimeout(resolve15, 750));
+    await new Promise((resolve16) => setTimeout(resolve16, 750));
     const payload = sentinel.payload;
     const summary = formatRestartSentinelMessage(payload);
     const sentinelSessionKey = this.normalizeOptionalString(payload.sessionKey);
@@ -9299,7 +9332,7 @@ var ServiceCommands = class {
       return;
     }
     const logPath = resolveServiceLogPath();
-    const logDir = resolve12(logPath, "..");
+    const logDir = resolve13(logPath, "..");
     mkdirSync5(logDir, { recursive: true });
     const logFd = openSync2(logPath, "a");
     const readinessTimeoutMs = this.resolveStartupTimeoutMs(options.startupTimeoutMs);
@@ -9441,14 +9474,14 @@ var ServiceCommands = class {
       const probe = await this.probeHealthEndpoint(params.healthUrl);
       if (!probe.healthy) {
         lastProbeError = probe.error;
-        await new Promise((resolve15) => setTimeout(resolve15, 200));
+        await new Promise((resolve16) => setTimeout(resolve16, 200));
         continue;
       }
-      await new Promise((resolve15) => setTimeout(resolve15, 300));
+      await new Promise((resolve16) => setTimeout(resolve16, 300));
       if (isProcessRunning(params.pid)) {
         return { ready: true, lastProbeError: null };
       }
-      await new Promise((resolve15) => setTimeout(resolve15, 200));
+      await new Promise((resolve16) => setTimeout(resolve16, 200));
     }
     return { ready: false, lastProbeError };
   }
@@ -9519,17 +9552,17 @@ var ServiceCommands = class {
     };
   }
   async checkPortAvailability(params) {
-    return await new Promise((resolve15) => {
+    return await new Promise((resolve16) => {
       const server = createNetServer2();
       server.once("error", (error) => {
-        resolve15({
+        resolve16({
           available: false,
           detail: `bind failed on ${params.host}:${params.port} (${String(error)})`
         });
       });
       server.listen(params.port, params.host, () => {
         server.close(() => {
-          resolve15({
+          resolve16({
             available: true,
             detail: `bind ok on ${params.host}:${params.port}`
           });
@@ -9565,7 +9598,7 @@ var ServiceCommands = class {
       return { healthy: false, error: "invalid health URL" };
     }
     const requestImpl = parsed.protocol === "https:" ? httpsRequest : httpRequest;
-    return new Promise((resolve15) => {
+    return new Promise((resolve16) => {
       const req = requestImpl(
         {
           protocol: parsed.protocol,
@@ -9601,19 +9634,19 @@ var ServiceCommands = class {
               if (bodySnippet) {
                 details.push(`body=${bodySnippet}`);
               }
-              resolve15({ healthy: false, error: details.join("; ") });
+              resolve16({ healthy: false, error: details.join("; ") });
               return;
             }
             try {
               const payload = JSON.parse(responseText);
               const healthy = payload?.ok === true && payload?.data?.status === "ok";
               if (!healthy) {
-                resolve15({ healthy: false, error: "health payload not ok" });
+                resolve16({ healthy: false, error: "health payload not ok" });
                 return;
               }
-              resolve15({ healthy: true, error: null });
+              resolve16({ healthy: true, error: null });
             } catch {
-              resolve15({ healthy: false, error: "invalid health JSON response" });
+              resolve16({ healthy: false, error: "invalid health JSON response" });
             }
           });
         }
@@ -9622,7 +9655,7 @@ var ServiceCommands = class {
         req.destroy(new Error("probe timeout"));
       });
       req.on("error", (error) => {
-        resolve15({ healthy: false, error: error.message || String(error) });
+        resolve16({ healthy: false, error: error.message || String(error) });
       });
       req.end();
     });
@@ -9768,9 +9801,9 @@ ${stderr}`.trim();
 // src/cli/workspace.ts
 import { cpSync as cpSync3, existsSync as existsSync12, mkdirSync as mkdirSync6, readFileSync as readFileSync9, readdirSync as readdirSync2, rmSync as rmSync6, writeFileSync as writeFileSync5 } from "fs";
 import { createRequire as createRequire2 } from "module";
-import { dirname as dirname4, join as join8, resolve as resolve13 } from "path";
+import { dirname as dirname4, join as join8, resolve as resolve14 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import { APP_NAME as APP_NAME4, getDataDir as getDataDir9 } from "@nextclaw/core";
+import { APP_NAME as APP_NAME4, getDataDir as getDataDir10 } from "@nextclaw/core";
 import { spawnSync as spawnSync3 } from "child_process";
 var WorkspaceManager = class {
   constructor(logo) {
@@ -9862,7 +9895,7 @@ var WorkspaceManager = class {
     try {
       const require3 = createRequire2(import.meta.url);
       const entry = require3.resolve("@nextclaw/core");
-      const pkgRoot = resolve13(dirname4(entry), "..");
+      const pkgRoot = resolve14(dirname4(entry), "..");
       const distSkills = join8(pkgRoot, "dist", "skills");
       if (existsSync12(distSkills)) {
         return distSkills;
@@ -9881,8 +9914,8 @@ var WorkspaceManager = class {
     if (override) {
       return override;
     }
-    const cliDir = resolve13(fileURLToPath4(new URL(".", import.meta.url)));
-    const pkgRoot = resolve13(cliDir, "..", "..");
+    const cliDir = resolve14(fileURLToPath4(new URL(".", import.meta.url)));
+    const pkgRoot = resolve14(cliDir, "..", "..");
     const candidates = [join8(pkgRoot, "templates")];
     for (const candidate of candidates) {
       if (existsSync12(candidate)) {
@@ -9892,7 +9925,7 @@ var WorkspaceManager = class {
     return null;
   }
   getBridgeDir() {
-    const userBridge = join8(getDataDir9(), "bridge");
+    const userBridge = join8(getDataDir10(), "bridge");
     if (existsSync12(join8(userBridge, "dist", "index.js"))) {
       return userBridge;
     }
@@ -9900,8 +9933,8 @@ var WorkspaceManager = class {
       console.error("npm not found. Please install Node.js >= 18.");
       process.exit(1);
     }
-    const cliDir = resolve13(fileURLToPath4(new URL(".", import.meta.url)));
-    const pkgRoot = resolve13(cliDir, "..", "..");
+    const cliDir = resolve14(fileURLToPath4(new URL(".", import.meta.url)));
+    const pkgRoot = resolve14(cliDir, "..", "..");
     const pkgBridge = join8(pkgRoot, "bridge");
     const srcBridge = join8(pkgRoot, "..", "..", "bridge");
     let source = null;
@@ -9915,7 +9948,7 @@ var WorkspaceManager = class {
       process.exit(1);
     }
     console.log(`${this.logo} Setting up bridge...`);
-    mkdirSync6(resolve13(userBridge, ".."), { recursive: true });
+    mkdirSync6(resolve14(userBridge, ".."), { recursive: true });
     if (existsSync12(userBridge)) {
       rmSync6(userBridge, { recursive: true, force: true });
     }
@@ -10067,7 +10100,7 @@ var CliRuntime = class {
     const delayMs = typeof params.delayMs === "number" && Number.isFinite(params.delayMs) ? Math.max(0, Math.floor(params.delayMs)) : 100;
     const cliPath = process.env.NEXTCLAW_SELF_RELAUNCH_CLI?.trim() || fileURLToPath5(new URL("./index.js", import.meta.url));
     const startArgs = [cliPath, "start", "--ui-port", String(uiPort)];
-    const serviceStatePath = resolve14(getDataDir10(), "run", "service.json");
+    const serviceStatePath = resolve15(getDataDir11(), "run", "service.json");
     const helperScript = [
       'const { spawnSync } = require("node:child_process");',
       'const { readFileSync } = require("node:fs");',
@@ -10199,7 +10232,7 @@ var CliRuntime = class {
     const createdConfig = initializeConfigIfMissing(configPath);
     const config2 = loadConfig21();
     const workspaceSetting = config2.agents.defaults.workspace;
-    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join9(getDataDir10(), DEFAULT_WORKSPACE_DIR) : expandHome2(workspaceSetting);
+    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join9(getDataDir11(), DEFAULT_WORKSPACE_DIR) : expandHome2(workspaceSetting);
     const workspaceExisted = existsSync13(workspacePath);
     mkdirSync7(workspacePath, { recursive: true });
     const templateResult = this.workspaceManager.createWorkspaceTemplates(
@@ -10392,8 +10425,8 @@ ${this.logo} ${APP_NAME5} is ready! (${source})`);
         `${this.logo} Interactive mode (type exit or Ctrl+C to quit)
 `
       );
-      const historyFile = join9(getDataDir10(), "history", "cli_history");
-      const historyDir = resolve14(historyFile, "..");
+      const historyFile = join9(getDataDir11(), "history", "cli_history");
+      const historyDir = resolve15(historyFile, "..");
       mkdirSync7(historyDir, { recursive: true });
       const history = existsSync13(historyFile) ? readFileSync10(historyFile, "utf-8").split("\n").filter(Boolean) : [];
       const rl = createInterface3({
@@ -10685,10 +10718,11 @@ channels.command("add").description("Configure a plugin channel (OpenClaw-compat
 channels.command("status").description("Show channel status").action(() => runtime.channelsStatus());
 channels.command("login").description("Link device via QR code").option("--channel <id>", "Plugin channel id").option("--account <id>", "Channel account id").option("--url <url>", "Channel API base URL").option("--http-url <url>", "Alias for --url").option("-v, --verbose", "Verbose output", false).action(async (opts) => runtime.channelsLogin(opts));
 var cron = program.command("cron").description("Manage scheduled tasks");
-cron.command("list").option("-a, --all", "Include disabled jobs").action(async (opts) => runtime.cronList(opts));
+cron.command("list").option("--enabled-only", "Show only enabled jobs", false).option("-a, --all", "Deprecated: list all jobs (default behavior)", false).action(async (opts) => runtime.cronList({ enabledOnly: Boolean(opts.enabledOnly) }));
 cron.command("add").requiredOption("-n, --name <name>", "Job name").requiredOption("-m, --message <message>", "Message for agent").option("-e, --every <seconds>", "Run every N seconds").option("-c, --cron <expr>", "Cron expression").option("--at <iso>", "Run once at time (ISO format)").option("-d, --deliver", "Deliver response to channel").option("--to <recipient>", "Recipient for delivery").option("--channel <channel>", "Channel for delivery").option("--account <id>", "Account id for channel delivery").action(async (opts) => runtime.cronAdd(opts));
 cron.command("remove <jobId>").action(async (jobId) => runtime.cronRemove(jobId));
 cron.command("enable <jobId>").option("--disable", "Disable instead of enable").action(async (jobId, opts) => runtime.cronEnable(jobId, opts));
+cron.command("disable <jobId>").action(async (jobId) => runtime.cronEnable(jobId, { disable: true }));
 cron.command("run <jobId>").option("-f, --force", "Run even if disabled").action(async (jobId, opts) => runtime.cronRun(jobId, opts));
 program.command("status").description(`Show ${APP_NAME6} status`).option("--json", "Output JSON", false).option("--verbose", "Show extra diagnostics", false).option("--fix", "Fix stale service state when safe", false).action(async (opts) => runtime.status(opts));
 program.command("doctor").description(`Run ${APP_NAME6} diagnostics`).option("--json", "Output JSON", false).option("--verbose", "Show extra diagnostics", false).option("--fix", "Fix stale service state when safe", false).action(async (opts) => runtime.doctor(opts));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.16.20",
+  "version": "0.16.22",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -39,16 +39,16 @@
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
     "yaml": "^2.8.1",
-    "@nextclaw/core": "0.11.7",
-    "@nextclaw/mcp": "0.1.54",
-    "@nextclaw/ncp": "0.4.1",
     "@nextclaw/ncp-agent-runtime": "0.3.1",
-    "@nextclaw/ncp-mcp": "0.1.55",
+    "@nextclaw/core": "0.11.9",
+    "@nextclaw/ncp-mcp": "0.1.57",
+    "@nextclaw/ncp": "0.4.1",
+    "@nextclaw/mcp": "0.1.56",
+    "@nextclaw/remote": "0.1.66",
+    "@nextclaw/runtime": "0.2.23",
     "@nextclaw/ncp-toolkit": "0.4.7",
-    "@nextclaw/remote": "0.1.64",
-    "@nextclaw/runtime": "0.2.21",
-    "@nextclaw/server": "0.11.12",
-    "@nextclaw/openclaw-compat": "0.3.46"
+    "@nextclaw/server": "0.11.14",
+    "@nextclaw/openclaw-compat": "0.3.48"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",

package/templates/USAGE.md

@@ -502,10 +502,11 @@ Created under the workspace:
 | `nextclaw doctor` | Run runtime diagnostics (`--json`, `--verbose`, `--fix`) |
 | `nextclaw channels login` | Open QR login for supported channels |
 | `nextclaw channels add --channel <id> ...` | Configure plugin channel via setup adapter |
-| `nextclaw cron list` | List scheduled jobs |
+| `nextclaw cron list` | List all scheduled jobs, including disabled ones |
 | `nextclaw cron add ...` | Add a cron job (see [Cron](#cron--heartbeat)) |
 | `nextclaw cron remove <jobId>` | Remove a job |
-| `nextclaw cron enable <jobId>` | Enable a job (use `--disable` to disable) |
+| `nextclaw cron enable <jobId>` | Enable a disabled job |
+| `nextclaw cron disable <jobId>` | Disable a job without deleting it |
 | `nextclaw cron run <jobId>` | Run a job once (optionally with `--force` if disabled) |
 | `nextclaw skills install <slug>` | Install a skill from NextClaw marketplace |
 | `nextclaw skills publish <dir>` | Upload/create a skill to marketplace |
@@ -944,12 +945,19 @@ Optional: deliver the agent’s reply to a channel:
 nextclaw cron add -n "daily" -m "Daily briefing" -c "0 9 * * *" --deliver --to <recipient> --channel <channel>
 ```
 
-Remove, enable, or disable a job:
+List all jobs by default, or only enabled ones if needed:
+
+```bash
+nextclaw cron list
+nextclaw cron list --enabled-only
+```
+
+Remove or change a job's enabled state:
 
 ```bash
 nextclaw cron remove <jobId>
 nextclaw cron enable <jobId>
-nextclaw cron enable <jobId> --disable
+nextclaw cron disable <jobId>
 ```
 
 Run a job once (e.g. for testing):