zelari-code 2.42.0 → 2.43.0

package/dist/cli/main.bundled.js

@@ -19304,22 +19304,54 @@ var init_walk = __esm({
 // packages/core/dist/core/tools/builtin/search.js
 import { promises as fs7 } from "node:fs";
 import path10 from "node:path";
+function cleanGlobFragment(g) {
+  let out = g.trim();
+  if (out.startsWith("[") && out.charAt(1) === '"')
+    out = out.slice(1);
+  if (out.endsWith("]") && out.charAt(out.length - 2) === '"')
+    out = out.slice(0, -1);
+  if (out.length >= 2 && (out.charAt(0) === '"' && out.charAt(out.length - 1) === '"' || out.charAt(0) === "'" && out.charAt(out.length - 1) === "'")) {
+    out = out.slice(1, -1).trim();
+  }
+  return out;
+}
+function isJsonArrayString(value) {
+  if (typeof value !== "string")
+    return false;
+  const s = value.trim();
+  if (!s.startsWith("[") || !s.endsWith("]"))
+    return false;
+  try {
+    return Array.isArray(JSON.parse(s));
+  } catch {
+    return false;
+  }
+}
 function coerceStringList(value, fallback) {
   if (value === void 0 || value === null)
     return fallback;
   if (Array.isArray(value)) {
-    const cleaned = value.filter((x) => typeof x === "string" && x.trim().length > 0);
+    const cleaned = value.map((x) => typeof x === "string" ? cleanGlobFragment(x) : x).filter((x) => typeof x === "string" && x.trim().length > 0);
     return cleaned.length > 0 ? cleaned : fallback;
   }
   if (typeof value === "string") {
     const s = value.trim();
     if (!s)
       return fallback;
+    if (s.startsWith("[") && s.endsWith("]")) {
+      try {
+        const parsed = JSON.parse(s);
+        if (Array.isArray(parsed))
+          return coerceStringList(parsed, fallback);
+      } catch {
+      }
+    }
     if (s.includes(",") && !s.includes("{")) {
-      const parts = s.split(",").map((x) => x.trim()).filter(Boolean);
+      const parts = s.split(",").map((x) => cleanGlobFragment(x)).filter(Boolean);
       return parts.length > 0 ? parts : fallback;
     }
-    return [s];
+    const single = cleanGlobFragment(s);
+    return single ? [single] : fallback;
   }
   return fallback;
 }
@@ -19425,7 +19457,7 @@ var init_search = __esm({
     });
     grepContentTool = {
       name: "grep_content",
-      description: `Regex search for content in a file OR recursively in a directory. When path is a directory, include/exclude globs filter which files are searched (default: all files, excluding node_modules/dist/.git/etc.). Glob semantics (grep --include style): a glob without '/' (e.g. "*.md") matches the file basename at ANY depth; a glob with '/' (e.g. "src/*.ts") matches the relative path at exactly that level; "**" is explicit recursion ("**/*.ts" matches at any depth, same as the bare form). include/exclude accept a single glob string (e.g. "*.ts") OR an array of globs. Returns matches with line numbers and context, plus filesWalked/filesInTree counts and a warning when the include globs matched suspiciously few files.`,
+      description: `Regex search for content in a file OR recursively in a directory. When path is a directory, include/exclude globs filter which files are searched (default: all files, excluding node_modules/dist/.git/etc.). Glob semantics (grep --include style): a glob without '/' (e.g. "*.md") matches the file basename at ANY depth; a glob with '/' (e.g. "src/*.ts") matches the relative path at exactly that level; "**" is explicit recursion ("**/*.ts" matches at any depth, same as the bare form). include/exclude accept a single glob string (e.g. "*.ts") OR an array of globs. Stringified-array ('["*.ts"]') or quote-wrapped forms are auto-repaired, with a warning. Returns matches with line numbers and context, plus filesWalked/filesInTree counts and a warning when the include globs matched suspiciously few files.`,
       permissions: ["read"],
       sideEffect: "none",
       timeoutMs: 3e4,
@@ -19440,9 +19472,14 @@ var init_search = __esm({
           const warnings = [];
           if (Array.isArray(rawInclude) && rawInclude.length === 0) {
             warnings.push('DEPRECATED_INPUT: empty include array \u2014 omit the field instead; this will become INVALID_ARGUMENT (planned v1.47). Fell back to ["*"]');
+          } else if (isJsonArrayString(rawInclude)) {
+            warnings.push(`include repaired from stringified-array form to ${JSON.stringify(include)}`);
           } else if (typeof rawInclude === "string") {
             warnings.push(`include coerced from bare string to ${JSON.stringify(include)}`);
           }
+          if (isJsonArrayString(args.exclude)) {
+            warnings.push(`exclude repaired from stringified-array form to ${JSON.stringify(exclude)}`);
+          }
           if (!await isDirectory(absRoot)) {
             let exists = true;
             try {
@@ -29044,22 +29081,32 @@ function parseMinimaxStyleToolCalls(text) {
 }
 function parseLooseArgs(body) {
   const args = {};
-  const paramTag = /(?:parameter\s+name=|<\s*)["']?([a-zA-Z_][\w]*)["']?\s*(?:>|=\s*["']?)([^<\]\n]+)/gi;
+  const paramFull = /<parameter\s+name=["']([a-zA-Z_][\w]*)["']\s*>([\s\S]*?)<\/parameter>/gi;
   let m;
-  while ((m = paramTag.exec(body)) !== null) {
+  while ((m = paramFull.exec(body)) !== null) {
+    const key = m[1];
+    if (["invoke", "minimax", "tool_call", "parameter"].includes(key))
+      continue;
+    args[key] = coerceJsonishValue(m[2]);
+  }
+  const rest = body.replace(/<parameter\s+name=["'][a-zA-Z_][\w]*["']\s*>[\s\S]*?<\/parameter>/gi, " ");
+  const paramTag = /(?:parameter\s+name=|<\s*)["']?([a-zA-Z_][\w]*)["']?\s*(?:>|=\s*["']?)([^<\]\n]+)/gi;
+  while ((m = paramTag.exec(rest)) !== null) {
     const key = m[1];
     if (key === "invoke" || key === "minimax" || key === "tool_call")
       continue;
-    args[key] = m[2].replace(/^["']|["']$/g, "").trim();
+    if (args[key] !== void 0)
+      continue;
+    args[key] = coerceJsonishValue(m[2]);
   }
   const lineRe = /(?:^|[\s\[>])([a-zA-Z_][\w]*)\s*[>:=]\s*([^\n<\]]+)/g;
-  while ((m = lineRe.exec(body)) !== null) {
+  while ((m = lineRe.exec(rest)) !== null) {
     const key = m[1];
     if (args[key] !== void 0)
       continue;
     if (["invoke", "name", "minimax", "tool_call", "parameter"].includes(key))
       continue;
-    args[key] = m[2].replace(/^["']|["']$/g, "").trim();
+    args[key] = coerceJsonishValue(m[2]);
   }
   if (Object.keys(args).length === 0) {
     const brace = body.indexOf("{");
@@ -29075,6 +29122,20 @@ function parseLooseArgs(body) {
   }
   return args;
 }
+function coerceJsonishValue(raw) {
+  const t = raw.trim();
+  if (t.startsWith("[") || t.startsWith("{")) {
+    try {
+      return JSON.parse(t);
+    } catch {
+    }
+    try {
+      return JSON.parse(t + (t.startsWith("[") ? "]" : "}"));
+    } catch {
+    }
+  }
+  return t.replace(/^["']|["']$/g, "").trim();
+}
 function tryParseToolArray(raw) {
   let parsed;
   try {
@@ -38837,7 +38898,7 @@ var CORE_VERSION;
 var init_version = __esm({
   "packages/core/dist/version.js"() {
     "use strict";
-    CORE_VERSION = "2.42.0";
+    CORE_VERSION = "2.43.0";
   }
 });
 
@@ -41728,8 +41789,15 @@ import path36 from "node:path";
 function radioDir(cwd) {
   return path36.join(cwd, ".zelari", "radio");
 }
+function processFallbackRadioId() {
+  if (fallbackRadioId === null) {
+    fallbackRadioId = `default-${process.pid}-${Date.now().toString(36)}`;
+  }
+  return fallbackRadioId;
+}
 function radioPath(cwd, sessionId2) {
-  const safe = (sessionId2 || "default").replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
+  const id3 = sessionId2.trim() ? sessionId2 : processFallbackRadioId();
+  const safe = id3.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
   return path36.join(radioDir(cwd), `${safe}.jsonl`);
 }
 function appendRadioLine(file2, line) {
@@ -41824,10 +41892,11 @@ function formatKrakenRadioStatus(cwd, sessionId2, limit = 12) {
   });
   return [`Kraken radio (last ${events.length}) session=${sessionId2}:`, ...lines].join("\n");
 }
-var MAX_CACHED_RADIO_FDS, radioFds;
+var fallbackRadioId, MAX_CACHED_RADIO_FDS, radioFds;
 var init_krakenRadio = __esm({
   "src/cli/tools/krakenRadio.ts"() {
     "use strict";
+    fallbackRadioId = null;
     MAX_CACHED_RADIO_FDS = 32;
     radioFds = /* @__PURE__ */ new Map();
   }
@@ -47862,7 +47931,10 @@ async function runTentacle(opts) {
     emitActivity({
       type: "agent_ended",
       agentId: id3,
-      reason: info.detail ?? (info.ok === false ? "failed" : "completed"),
+      // t102: `reason` feeds a failure-heuristic on the Desktop; free text in
+      // it (result excerpt) could flip a SUCCESSFUL tentacle to "failed".
+      // Only genuine failures carry detail; successes are enum-only.
+      reason: info.ok === false ? info.detail ?? "failed" : "completed",
       ok: info.ok !== false,
       durationMs: info.durationMs ?? 0,
       ts: Date.now()
@@ -55329,14 +55401,18 @@ function activePermissionPreset() {
   return parsePermissionPreset(process.env.ZELARI_PERMISSION_PRESET) ?? "standard";
 }
 function defaultPermissionPolicy(overrides) {
-  const preset = PERMISSION_PRESETS[activePermissionPreset()];
+  const presetName = activePermissionPreset();
+  const preset = PERMISSION_PRESETS[presetName];
   return {
     read: parseAction(process.env.ZELARI_PERMISSION_READ, preset.read),
     write: parseAction(process.env.ZELARI_PERMISSION_WRITE, preset.write),
     execute: parseAction(process.env.ZELARI_PERMISSION_EXECUTE, preset.execute),
     network: parseAction(process.env.ZELARI_PERMISSION_NETWORK, preset.network),
     ui: "allow",
-    auto: isAutoPermissions(),
+    // yolo means "go alone": residual asks auto-approve without a UI handler
+    // (no more "denied timed out" piles on unattended builds). Explicit
+    // ZELARI_AUTO=1 keeps working for every preset; deny is never promoted.
+    auto: isAutoPermissions() || presetName === "yolo",
     ...overrides
   };
 }
@@ -56460,9 +56536,11 @@ function createBuiltinToolRegistry(options = {}) {
   const gauntletParent = options.gauntletParent === true;
   const allowMutators = !readOnly && !verifyMode && !gauntletParent;
   const allowBash = (allowMutators || verifyMode) && !gauntletParent;
-  if (isParent && allowMutators && sessionId2) {
-    registry4.setToolResultListener(createTaskTouchGuard({ projectRoot: root, sessionId: sessionId2 }));
-    void runTaskStalenessCheck({ projectRoot: root, sessionId: sessionId2 });
+  if (isParent && allowMutators && options.sessionId) {
+    registry4.setToolResultListener(
+      createTaskTouchGuard({ projectRoot: root, sessionId: options.sessionId })
+    );
+    void runTaskStalenessCheck({ projectRoot: root, sessionId: options.sessionId });
   }
   const permPolicy = options.permissionPolicy ?? defaultPermissionPolicy();
   const agentPolicySet = (() => {
@@ -87435,7 +87513,7 @@ proposals: npm run evolve:propose \u2014 decisions in npm run evolve:decide (P1:
   }
   if (argv.includes("--help") || argv.includes("-h")) {
     console.log(
-      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor [--json]   Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --inspect [--json]  Unified project inspection (config, skills, MCP,\n                      hooks, plugins, AGENTS.md, trust status)\n  --trust [path]      Trust the cwd (or path) so project MCP + hooks load\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --fix-budget        Set recommended ZELARI_MAX_TOOL_LOOP_HARD=180,\n                      ZELARI_MAX_TOOL_LOOP_ITERATIONS=60, ZELARI_CONTEXT_LIMIT=400000\n                      at User scope (prevents the agent stopping mid-task)\n  --permission-mcp <socket>  MCP stdio server for external agent permission prompts\n                      (spawned by claude --permission-prompt-tool)\n  --memory-mcp       Optional MCP stdio server for project memory\n    --cwd <path>      Trusted project root (requires ZELARI_MEMORY_MCP=1)\n    --client-id <id>  Stable local owner identity for private memories\n  --memory-json <json>  Read-only project-memory bridge for Zelari Desktop\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode kraken|council|zelari  Dispatch mode (default: kraken; agent=alias)\n                      zelari/mission mode auto-scopes slices from open tasks in .zelari/plan.json\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n    --profile <id>     Capability profile (minimal/v1|kraken/v1|council/v1|mission/v1)\n    --resume <id>      Continue a 2.0 spine session\n    --resume-mission   Resume .zelari/mission-state.json (not the spine)\n    --export-session <path>  Write zelari-session-export/1 after the run\n    --strict-done      Evidence-based BUILD completion gate\n    --allow-unverified  Exit 0 when strict is ON but nothing could be verified (M1.2)\n    --task-file <path>  Read the task prompt from a file (Windows argv cap)\n    --once             Single-cycle run (cron/git-hook triggers, ADR-0014)\n    --kraken-graph <goal>  Plan + execute a Kraken task graph\n                      (variant: --kraken-graph-file <path>; kill-switch\n                      ZELARI_KRAKEN_GRAPH=0)\n    --plan-only        Serialize the graph plan to .zelari/radio/ and exit 0\n    --run-plan <id>    Execute a pre-built .zelari/radio/plan-<id>.json\n    --gauntlet         Host-driven gauntlet loop (builder/critic tentacles)\n  --session-export <id>  Print a portable 2.0 session export (no LLM)\n  serve               Companion host for Android/remote clients (Tailscale)\n    --bind <ip>       Listen address (default: 127.0.0.1; use Tailscale IP)\n    --port <n>        Port (default: 7421)\n    --token <secret>  Bearer token (default: ~/.zelari-code/companion.token)\n    --project <path>  Allowlisted project root (repeatable)\n    --save-projects   Persist --project list to companion.json\n  --serve-harness     Long-lived harness kernel for hosts (NDJSON JSON-RPC\n                      on stdin/stdout; Desktop/companion transport)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --print-settings    Print zelari.config.json values + the origin of\n                      each (default < user < project < env)\n  --permissions <p>   Permission preset: strict | standard | yolo \u2014 changes\n                      category DEFAULTS only (env vars and policy files win)\n  --evolve-status     Evolution ledger stats (read-only; ADR-0036; the\n                      ledger is written only when ZELARI_EVOLUTION=shadow)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n    --thinking <spec>  Thinking effort (auto|off|low|medium|high|budget:N)\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --login-oauth       Start subscription OAuth (grok, chatgpt, anthropic)\n    --provider <id>    grok | chatgpt | anthropic\n    --code <paste>    Anthropic magic-link code (CODE#STATE)\n    --no-browser      Do not open the system browser\n  --refresh-oauth     Force-refresh an OAuth access token\n    --provider <id>    grok | chatgpt | anthropic\n  --logout-oauth      Clear stored OAuth credentials\n    --provider <id>    grok | chatgpt | anthropic\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable for stdio servers\n    --url <endpoint>  Streamable HTTP endpoint (e.g. UE 5.8 editor)\n    --args <json>     JSON array of args (stdio, optional)\n    --env <json|K=V>  Env for the server: JSON object or KEY=VALUE,\n                      repeatable (omit to keep the stored env)\n    --timeout <ms>    Per-server request timeout (http, optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --preset unreal-mcp  Unreal Engine 5.8+ editor (MCP over HTTP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-skills      Print skills (builtin + user + project)\n    --cwd <path>      Project root for .zelari/skills\n  --set-skill         Add/update a SKILL.md skill\n    --name <id>       Skill id (required)\n    --description <t> One-line description (required)\n    --body <text>     Markdown instructions (required)\n    --category <c>    plan|refactor|debug|review|test|docs|ops|git|db|maint\n    --tools <csv>     Comma-separated required tools (optional)\n    --cost <l>        low|medium|high (default: medium)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-skill      Remove a user/project SKILL.md\n    --name <id> --scope user|project [--cwd <path>]\n  --generate-skill-from-url  Fetch URL + draft skill via model (JSON)\n    --url <https://...>  Required\n    --provider <id>   Override active provider\n    --model <name>    Override model for the selected provider\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ZELARI_MEMORY_MCP=1  Enable the optional external memory MCP server\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
+      "zelari-code \u2014 AI Council coding agent CLI.\n\nUsage: zelari-code [options]\n\nOptions:\n  --version, -v       Print version and exit\n  --help, -h          Print this help and exit\n  --doctor [--json]   Diagnose install health (shim, bundle, PATH, deps,\n                      node/git/bash in the agent shell)\n  --inspect [--json]  Unified project inspection (config, skills, MCP,\n                      hooks, plugins, AGENTS.md, trust status)\n  --trust [path]      Trust the cwd (or path) so project MCP + hooks load\n  --fix-path          Add the npm global prefix to the user PATH\n                      (Windows only; fixes 'command not found' after install)\n  --fix-budget        Set recommended ZELARI_MAX_TOOL_LOOP_HARD=180,\n                      ZELARI_MAX_TOOL_LOOP_ITERATIONS=60, ZELARI_CONTEXT_LIMIT=400000\n                      at User scope (prevents the agent stopping mid-task)\n  --permission-mcp <socket>  MCP stdio server for external agent permission prompts\n                      (spawned by claude --permission-prompt-tool)\n  --memory-mcp       Optional MCP stdio server for project memory\n    --cwd <path>      Trusted project root (requires ZELARI_MEMORY_MCP=1)\n    --client-id <id>  Stable local owner identity for private memories\n  --memory-json <json>  Read-only project-memory bridge for Zelari Desktop\n  --skip-checks       Skip the boot-time prerequisite check\n                      (alias for ZELARI_SKIP_PREFLIGHT=1)\n  --no-wizard         Skip the first-run wizard\n  --reset-config      Re-run the wizard (clears provider.json on commit)\n  --headless          Run a single task without mounting the TUI\n    --task <text>       Task prompt (required in headless mode)\n    --output json|plain Output format (default: json)\n    --mode kraken|council|zelari  Dispatch mode (default: kraken; agent=alias)\n                      zelari/mission mode auto-scopes slices from open tasks in .zelari/plan.json\n    --council          Alias for --mode council\n    --phase plan|build  Work phase (default: build)\n    --provider <id>    Provider override (default: active)\n    --model <id>       Model override (default: provider default)\n    --profile <id>     Capability profile (minimal/v1|kraken/v1|council/v1|mission/v1)\n    --resume <id>      Continue a 2.0 spine session\n    --resume-mission   Resume .zelari/mission-state.json (not the spine)\n    --export-session <path>  Write zelari-session-export/1 after the run\n    --strict-done      Evidence-based BUILD completion gate\n    --allow-unverified  Exit 0 when strict is ON but nothing could be verified (M1.2)\n    --task-file <path>  Read the task prompt from a file (Windows argv cap)\n    --once             Single-cycle run (cron/git-hook triggers, ADR-0014)\n    --kraken-graph <goal>  Plan + execute a Kraken task graph\n                      (variant: --kraken-graph-file <path>; kill-switch\n                      ZELARI_KRAKEN_GRAPH=0)\n    --plan-only        Serialize the graph plan to .zelari/radio/ and exit 0\n    --run-plan <id>    Execute a pre-built .zelari/radio/plan-<id>.json\n    --gauntlet         Host-driven gauntlet loop (builder/critic tentacles)\n  --session-export <id>  Print a portable 2.0 session export (no LLM)\n  serve               Companion host for Android/remote clients (Tailscale)\n    --bind <ip>       Listen address (default: 127.0.0.1; use Tailscale IP)\n    --port <n>        Port (default: 7421)\n    --token <secret>  Bearer token (default: ~/.zelari-code/companion.token)\n    --project <path>  Allowlisted project root (repeatable)\n    --save-projects   Persist --project list to companion.json\n  --serve-harness     Long-lived harness kernel for hosts (NDJSON JSON-RPC\n                      on stdin/stdout; Desktop/companion transport)\n  --print-config      Print provider/model config as JSON (no secrets)\n  --print-settings    Print zelari.config.json values + the origin of\n                      each (default < user < project < env)\n  --permissions <p>   Permission preset: strict | standard | yolo \u2014 changes\n                      category DEFAULTS only (env vars and policy files win);\n                      yolo also auto-approves residual asks (unattended runs)\n  --evolve-status     Evolution ledger stats (read-only; ADR-0036; the\n                      ledger is written only when ZELARI_EVOLUTION=shadow)\n  --plugins-status    JSON status of optional plugins (Playwright, eslint, \u2026)\n  --plugins-install <id>  Install plugin (playwright also fetches Chromium)\n    --cwd <path>       Workspace for -D installs (default: process.cwd())\n  --set-config        Persist provider/model/endpoint\n    --provider <id>    Set active provider\n    --model <id>       Set model for that provider\n    --endpoint <url>   Custom OpenAI-compatible base URL\n    --endpoint-clear   Remove custom endpoint override\n    --thinking <spec>  Thinking effort (auto|off|low|medium|high|budget:N)\n  --set-key           Store an API key (never printed back)\n    --provider <id>    Provider id (required)\n    --key <secret>     API key (required)\n  --login-oauth       Start subscription OAuth (grok, chatgpt, anthropic)\n    --provider <id>    grok | chatgpt | anthropic\n    --code <paste>    Anthropic magic-link code (CODE#STATE)\n    --no-browser      Do not open the system browser\n  --refresh-oauth     Force-refresh an OAuth access token\n    --provider <id>    grok | chatgpt | anthropic\n  --logout-oauth      Clear stored OAuth credentials\n    --provider <id>    grok | chatgpt | anthropic\n  --discover-models   Refresh model list for a provider\n    --provider <id>    Provider (default: active)\n  --print-mcp         Print MCP server config (user + project)\n    --cwd <path>      Project root for .zelari/mcp.json\n  --set-mcp           Add/update an MCP server entry\n    --name <id>       Server name (required)\n    --command <bin>   Executable for stdio servers\n    --url <endpoint>  Streamable HTTP endpoint (e.g. UE 5.8 editor)\n    --args <json>     JSON array of args (stdio, optional)\n    --env <json|K=V>  Env for the server: JSON object or KEY=VALUE,\n                      repeatable (omit to keep the stored env)\n    --timeout <ms>    Per-server request timeout (http, optional)\n    --scope user|project  Default: user\n    --enabled true|false  Default: true\n    --cwd <path>      Required when scope=project\n  --set-mcp-preset    Install a named MCP preset (e.g. cua)\n    --preset cua      Cua Driver desktop computer-use (MCP)\n    --preset unreal-mcp  Unreal Engine 5.8+ editor (MCP over HTTP)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-mcp        Remove an MCP server entry\n    --name <id> --scope user|project [--cwd <path>]\n  --print-skills      Print skills (builtin + user + project)\n    --cwd <path>      Project root for .zelari/skills\n  --set-skill         Add/update a SKILL.md skill\n    --name <id>       Skill id (required)\n    --description <t> One-line description (required)\n    --body <text>     Markdown instructions (required)\n    --category <c>    plan|refactor|debug|review|test|docs|ops|git|db|maint\n    --tools <csv>     Comma-separated required tools (optional)\n    --cost <l>        low|medium|high (default: medium)\n    --scope user|project  Default: user\n    --cwd <path>      Required when scope=project\n  --remove-skill      Remove a user/project SKILL.md\n    --name <id> --scope user|project [--cwd <path>]\n  --generate-skill-from-url  Fetch URL + draft skill via model (JSON)\n    --url <https://...>  Required\n    --provider <id>   Override active provider\n    --model <name>    Override model for the selected provider\n  --print-ssh-targets Print SSH deploy/monitor targets\n  --set-ssh-target    Upsert target (--json '{...}' or flags)\n  --remove-ssh-target --id <id>\n  --test-ssh-target   --id <id>  (BatchMode ssh true)\n  --print-ssh-pubkey  --path <private-or-.pub>  (display public key)\n\nEnvironment:\n  ZELARI_NO_WIZARD=1    Skip the first-run wizard\n  ZELARI_SKIP_PREFLIGHT=1  Skip the boot prerequisite check\n  ZELARI_NO_PLUGIN_PROMPT=1  Skip the boot plugin-install prompt\n  ZELARI_MEMORY_MCP=1  Enable the optional external memory MCP server\n  ANATHEMA_DEV=1        Disable background update check + preflight\n"
     );
     process.exit(0);
   }