@vm0/cli 9.5.0 → 9.6.0

package/index.js

@@ -1878,7 +1878,7 @@ var credentialsByNameContract = c10.router({
       name: credentialNameSchema
     }),
     responses: {
-      204: z13.undefined(),
+      204: c10.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema,
       500: apiErrorSchema
@@ -1990,7 +1990,7 @@ var modelProvidersByTypeContract = c11.router({
       type: modelProviderTypeSchema
     }),
     responses: {
-      204: z14.undefined(),
+      204: c11.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema,
       500: apiErrorSchema
@@ -2275,7 +2275,7 @@ var schedulesByNameContract = c13.router({
       composeId: z16.string().uuid("Compose ID required")
     }),
     responses: {
-      204: z16.undefined(),
+      204: c13.noBody(),
       401: apiErrorSchema,
       404: apiErrorSchema
     },
@@ -3246,10 +3246,10 @@ async function getRawHeaders() {
   }
   return headers;
 }
-async function httpGet(path17) {
+async function httpGet(path16) {
   const baseUrl = await getBaseUrl();
   const headers = await getRawHeaders();
-  return fetch(`${baseUrl}${path17}`, {
+  return fetch(`${baseUrl}${path16}`, {
     method: "GET",
     headers
   });
@@ -3754,49 +3754,49 @@ var cliComposeSchema = z24.object({
 function formatZodError(error) {
   const issue = error.issues[0];
   if (!issue) return "Validation failed";
-  const path17 = issue.path.join(".");
+  const path16 = issue.path.join(".");
   const message = issue.message;
-  if (!path17) return message;
+  if (!path16) return message;
   if (issue.code === "invalid_type") {
     const received = issue.received;
     const isMissing = received === "undefined" || message.includes("received undefined") || message === "Required";
-    if (path17 === "version" && isMissing) {
+    if (path16 === "version" && isMissing) {
       return "Missing config.version";
     }
-    if (path17 === "agents" && isMissing) {
+    if (path16 === "agents" && isMissing) {
       return "Missing agents object in config";
     }
-    if (path17.startsWith("volumes.") && path17.endsWith(".name")) {
-      const volumeKey = path17.split(".")[1];
+    if (path16.startsWith("volumes.") && path16.endsWith(".name")) {
+      const volumeKey = path16.split(".")[1];
       return `Volume "${volumeKey}" must have a 'name' field (string)`;
     }
-    if (path17.startsWith("volumes.") && path17.endsWith(".version")) {
-      const volumeKey = path17.split(".")[1];
+    if (path16.startsWith("volumes.") && path16.endsWith(".version")) {
+      const volumeKey = path16.split(".")[1];
       return `Volume "${volumeKey}" must have a 'version' field (string)`;
     }
     if (issue.expected === "array") {
-      const fieldName = path17.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path16.replace(/^agents\.[^.]+\./, "agent.");
       return `${fieldName} must be an array`;
     }
     if (issue.expected === "string" && received === "number") {
-      const fieldName = path17.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path16.replace(/^agents\.[^.]+\./, "agent.");
       const match = fieldName.match(/^(agent\.[^.]+)\.\d+$/);
       if (match) {
         return `Each entry in ${match[1]?.replace("agent.", "")} must be a string`;
       }
     }
   }
-  if (issue.code === "invalid_key" && path17.startsWith("agents.")) {
+  if (issue.code === "invalid_key" && path16.startsWith("agents.")) {
     return "Invalid agent name format. Must be 3-64 characters, letters, numbers, and hyphens only. Must start and end with letter or number.";
   }
-  if (message === "Invalid key in record" && path17.startsWith("agents.")) {
+  if (message === "Invalid key in record" && path16.startsWith("agents.")) {
     return "Invalid agent name format. Must be 3-64 characters, letters, numbers, and hyphens only. Must start and end with letter or number.";
   }
   if (issue.code === "custom") {
     return message;
   }
-  if (path17.startsWith("agents.")) {
-    const cleanPath = path17.replace(/^agents\.[^.]+\./, "agent.");
+  if (path16.startsWith("agents.")) {
+    const cleanPath = path16.replace(/^agents\.[^.]+\./, "agent.");
     if (message.startsWith("Invalid input:")) {
       const match = message.match(/expected (\w+), received (\w+)/);
       if (match && match[1] === "string" && match[2] === "number") {
@@ -3808,7 +3808,7 @@ function formatZodError(error) {
     }
     return `${cleanPath}: ${message}`;
   }
-  return `${path17}: ${message}`;
+  return `${path16}: ${message}`;
 }
 function validateAgentName(name) {
   return cliAgentNameSchema.safeParse(name).success;
@@ -6007,7 +6007,7 @@ var ApiClient = class {
   /**
    * Generic GET request
    */
-  async get(path17) {
+  async get(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -6020,7 +6020,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "GET",
       headers
     });
@@ -6028,7 +6028,7 @@ var ApiClient = class {
   /**
    * Generic POST request
    */
-  async post(path17, options) {
+  async post(path16, options) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -6044,7 +6044,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "POST",
       headers,
       body: options?.body
@@ -6053,7 +6053,7 @@ var ApiClient = class {
   /**
    * Generic DELETE request
    */
-  async delete(path17) {
+  async delete(path16) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -6066,7 +6066,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path17}`, {
+    return fetch(`${baseUrl}${path16}`, {
       method: "DELETE",
       headers
     });
@@ -7871,8 +7871,10 @@ function execVm0Command(args, options = {}) {
 }
 function execVm0RunWithCapture(args, options = {}) {
   return new Promise((resolve, reject) => {
+    const env = process.stdout.isTTY ? { ...process.env, FORCE_COLOR: "1" } : process.env;
     const proc = spawn2("vm0", args, {
       cwd: options.cwd,
+      env,
       stdio: ["inherit", "pipe", "pipe"],
       shell: process.platform === "win32"
     });
@@ -8163,7 +8165,7 @@ var cookAction = new Command27().name("cook").description("Quick start: prepare,
 ).option("-y, --yes", "Skip confirmation prompts").addOption(new Option4("--debug-no-mock-claude").hideHelp()).addOption(new Option4("--no-auto-update").hideHelp()).action(
   async (prompt, options) => {
     if (!options.noAutoUpdate) {
-      const shouldExit = await checkAndUpgrade("9.5.0", prompt);
+      const shouldExit = await checkAndUpgrade("9.6.0", prompt);
       if (shouldExit) {
         process.exit(0);
       }
@@ -9111,13 +9113,16 @@ var initCommand3 = new Command38().name("init").description("Initialize a new VM
   console.log();
   console.log("Next steps:");
   console.log(
-    `  1. Set model provider (one-time): ${chalk37.cyan("vm0 model-provider setup")}`
+    `  1. Set up model provider (one-time): ${chalk37.cyan("vm0 model-provider setup")}`
   );
   console.log(
     `  2. Edit ${chalk37.cyan("AGENTS.md")} to customize your agent's workflow`
   );
   console.log(
-    `  3. Run your agent: ${chalk37.cyan(`vm0 cook "let's start working."`)}`
+    `     Or install Claude plugin: ${chalk37.cyan(`vm0 setup-claude && claude "/vm0-agent let's build an agent"`)}`
+  );
+  console.log(
+    `  3. Run your agent: ${chalk37.cyan(`vm0 cook "let's start working"`)}`
   );
 });
 
@@ -10744,31 +10749,30 @@ import { Command as Command56 } from "commander";
 import chalk56 from "chalk";
 import { mkdir as mkdir7 } from "fs/promises";
 import { existsSync as existsSync11 } from "fs";
-import path16 from "path";
 
 // src/lib/ui/welcome-box.ts
 import chalk53 from "chalk";
 var gradientColors = [
-  chalk53.hex("#FF9650"),
+  chalk53.hex("#FFAB5E"),
   // Line 1 - lightest
-  chalk53.hex("#FF7832"),
+  chalk53.hex("#FF9642"),
   // Line 2
-  chalk53.hex("#FF7832"),
+  chalk53.hex("#FF8228"),
   // Line 3
-  chalk53.hex("#ED4E01"),
-  // Line 4 - brand orange
-  chalk53.hex("#ED4E01"),
+  chalk53.hex("#FF6D0A"),
+  // Line 4
+  chalk53.hex("#E85D00"),
   // Line 5
-  chalk53.hex("#C83C00")
+  chalk53.hex("#CC4E00")
   // Line 6 - darkest
 ];
 var vm0LogoLines = [
-  "\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
   "\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557",
   "\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551",
   "\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551",
   " \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
-  "  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D"
+  "  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D "
 ];
 function renderVm0Banner() {
   console.log();
@@ -10781,73 +10785,79 @@ function renderVm0Banner() {
 function renderOnboardWelcome() {
   renderVm0Banner();
   console.log(`  ${chalk53.bold("Welcome to VM0!")}`);
-  console.log(`  ${chalk53.dim("Let's create your first agent.")}`);
+  console.log(
+    `  ${chalk53.dim("Build agentic workflows using natural language.")}`
+  );
   console.log();
 }
 
-// src/lib/ui/progress-line.ts
+// src/lib/ui/step-runner.ts
 import chalk54 from "chalk";
-function createProgressiveProgress(interactive = true) {
-  let currentLabel = "";
-  let detailLineCount = 0;
-  let isFinalStep = false;
-  const clearDetails = () => {
-    if (!interactive || detailLineCount === 0) return;
-    process.stdout.write(`\x1B[${detailLineCount + 1}A`);
-    process.stdout.write(`\x1B[K`);
-  };
-  const clearDetailLines = () => {
-    if (!interactive) return;
-    for (let i = 0; i < detailLineCount; i++) {
-      process.stdout.write(`
-\x1B[K`);
-    }
-    if (detailLineCount > 0) {
-      process.stdout.write(`\x1B[${detailLineCount}A`);
+function createStepRunner(options = true) {
+  const opts = typeof options === "boolean" ? { interactive: options } : options;
+  const interactive = opts.interactive ?? true;
+  const headerFn = opts.header;
+  const completedSteps = [];
+  function redrawCompletedSteps(isFinal) {
+    process.stdout.write("\x1B[2J\x1B[H");
+    if (headerFn) {
+      console.log();
+      headerFn();
+      console.log();
     }
-  };
-  return {
-    startStep: (label) => {
-      currentLabel = label;
-      detailLineCount = 0;
-      isFinalStep = false;
-      console.log(chalk54.yellow(`\u25CB ${label}`));
-    },
-    detail: (message) => {
-      console.log(chalk54.dim(`\u2502 ${message}`));
-      detailLineCount++;
-    },
-    completeStep: () => {
-      if (interactive && detailLineCount > 0) {
-        clearDetails();
-      } else if (interactive) {
-        process.stdout.write(`\x1B[1A\x1B[K`);
+    for (const [i, step] of completedSteps.entries()) {
+      if (step.failed) {
+        console.log(chalk54.red(`\u2717 ${step.label}`));
+      } else {
+        console.log(chalk54.green(`\u25CF ${step.label}`));
       }
-      console.log(chalk54.green(`\u25CF ${currentLabel}`));
-      if (interactive && detailLineCount > 0) {
-        clearDetailLines();
+      const isLastStep = i === completedSteps.length - 1;
+      if (!isLastStep || !isFinal) {
+        console.log(chalk54.dim("\u2502"));
       }
-      if (!isFinalStep) {
+    }
+  }
+  async function executeStep(label, fn, isFinal) {
+    let stepFailed = false;
+    console.log(chalk54.yellow(`\u25CB ${label}`));
+    const ctx = {
+      connector() {
         console.log(chalk54.dim("\u2502"));
+      },
+      detail(message) {
+        console.log(`${chalk54.dim("\u2502")} ${message}`);
+      },
+      async prompt(promptFn) {
+        return await promptFn();
       }
-      currentLabel = "";
-      detailLineCount = 0;
-    },
-    failStep: () => {
-      if (interactive && detailLineCount > 0) {
-        clearDetails();
-      } else if (interactive) {
-        process.stdout.write(`\x1B[1A\x1B[K`);
-      }
-      console.log(chalk54.red(`\u2717 ${currentLabel}`));
-      if (interactive && detailLineCount > 0) {
-        clearDetailLines();
-      }
-      currentLabel = "";
-      detailLineCount = 0;
+    };
+    try {
+      await fn(ctx);
+    } catch (error) {
+      stepFailed = true;
+      throw error;
+    } finally {
+      completedSteps.push({ label, failed: stepFailed });
+      if (interactive) {
+        redrawCompletedSteps(isFinal);
+      } else {
+        if (stepFailed) {
+          console.log(chalk54.red(`\u2717 ${label}`));
+        } else {
+          console.log(chalk54.green(`\u25CF ${label}`));
+        }
+        if (!isFinal) {
+          console.log(chalk54.dim("\u2502"));
+        }
+      }
+    }
+  }
+  return {
+    async step(label, fn) {
+      await executeStep(label, fn, false);
     },
-    setFinalStep: () => {
-      isFinalStep = true;
+    async finalStep(label, fn) {
+      await executeStep(label, fn, true);
     }
   };
 }
@@ -11084,175 +11094,199 @@ async function installVm0Plugin(scope = "user", cwd) {
 // src/commands/onboard/index.ts
 var DEFAULT_AGENT_NAME = "my-vm0-agent";
 async function handleAuthentication(ctx) {
-  ctx.progress.startStep("Authentication");
-  const authenticated = await isAuthenticated();
-  if (authenticated) {
-    ctx.progress.completeStep();
-    return;
-  }
-  if (!ctx.interactive) {
-    ctx.progress.failStep();
-    console.error(chalk56.red("Error: Not authenticated"));
-    console.error("Run 'vm0 auth login' first or set VM0_TOKEN");
-    process.exit(1);
-  }
-  await runAuthFlow({
-    onInitiating: () => {
-    },
-    onDeviceCodeReady: (url, code, expiresIn) => {
-      ctx.progress.detail(`Visit: ${url}`);
-      ctx.progress.detail(`Code: ${code}`);
-      ctx.progress.detail(`Expires in ${expiresIn} minutes`);
-      ctx.progress.detail("Waiting for confirmation...");
-    },
-    onPolling: () => {
-    },
-    onSuccess: () => {
-    },
-    onError: (error) => {
-      ctx.progress.failStep();
-      console.error(chalk56.red(`
-${error.message}`));
+  await ctx.runner.step("Authenticate to vm0.ai", async (step) => {
+    const authenticated = await isAuthenticated();
+    if (authenticated) {
+      return;
+    }
+    if (!ctx.interactive) {
+      console.error(chalk56.red("Error: Not authenticated"));
+      console.error("Run 'vm0 auth login' first or set VM0_TOKEN");
       process.exit(1);
     }
+    await runAuthFlow({
+      onInitiating: () => {
+      },
+      onDeviceCodeReady: (url, code, expiresIn) => {
+        step.detail(`Copy code: ${chalk56.cyan.bold(code)}`);
+        step.detail(`Open: ${chalk56.cyan(url)}`);
+        step.detail(chalk56.dim(`Expires in ${expiresIn} minutes`));
+      },
+      onPolling: () => {
+      },
+      onSuccess: () => {
+      },
+      onError: (error) => {
+        console.error(chalk56.red(`
+${error.message}`));
+        process.exit(1);
+      }
+    });
   });
-  ctx.progress.completeStep();
 }
 async function handleModelProvider(ctx) {
-  ctx.progress.startStep("Model Provider Setup");
-  const providerStatus = await checkModelProviderStatus();
-  if (providerStatus.hasProvider) {
-    ctx.progress.completeStep();
-    return;
-  }
-  if (!ctx.interactive) {
-    ctx.progress.failStep();
-    console.error(chalk56.red("Error: No model provider configured"));
-    console.error("Run 'vm0 model-provider setup' first");
-    process.exit(1);
-  }
-  ctx.progress.detail("Setup required...");
-  const choices = getProviderChoices();
-  const providerType = await promptSelect(
-    "Select provider type:",
-    choices.map((c20) => ({
-      title: c20.label,
-      value: c20.type,
-      description: c20.helpText
-    }))
-  );
-  if (!providerType) {
-    process.exit(0);
-  }
-  const selectedChoice = choices.find((c20) => c20.type === providerType);
-  const credential = await promptPassword(
-    `Enter your ${selectedChoice?.credentialLabel ?? "credential"}:`
-  );
-  if (!credential) {
-    console.log(chalk56.dim("Cancelled"));
-    process.exit(0);
-  }
-  const result = await setupModelProvider(providerType, credential);
-  ctx.progress.detail(
-    `${providerType} ${result.created ? "created" : "updated"}${result.isDefault ? ` (default for ${result.framework})` : ""}`
-  );
-  ctx.progress.completeStep();
-}
-async function handleAgentCreation(ctx) {
-  ctx.progress.startStep("Create Agent");
-  let agentName = ctx.options.name ?? DEFAULT_AGENT_NAME;
-  if (!ctx.options.yes && !ctx.options.name && ctx.interactive) {
-    const inputName = await promptText(
-      "Enter agent name:",
-      DEFAULT_AGENT_NAME,
-      (value) => {
-        if (!validateAgentName(value)) {
-          return "Invalid name: 3-64 chars, alphanumeric + hyphens, start/end with letter/number";
-        }
-        return true;
+  await ctx.runner.step("Set Up Model Provider", async (step) => {
+    const providerStatus = await checkModelProviderStatus();
+    if (providerStatus.hasProvider) {
+      return;
+    }
+    if (!ctx.interactive) {
+      console.error(chalk56.red("Error: No model provider configured"));
+      console.error("Run 'vm0 model-provider setup' first");
+      process.exit(1);
+    }
+    const choices = getProviderChoices();
+    step.connector();
+    const providerType = await step.prompt(
+      () => promptSelect(
+        "Select provider type:",
+        choices.map((c20) => ({
+          title: c20.label,
+          value: c20.type
+        }))
+      )
+    );
+    if (!providerType) {
+      process.exit(0);
+    }
+    const selectedChoice = choices.find((c20) => c20.type === providerType);
+    if (selectedChoice?.helpText) {
+      for (const line of selectedChoice.helpText.split("\n")) {
+        step.detail(chalk56.dim(line));
       }
+    }
+    const credential = await step.prompt(
+      () => promptPassword(
+        `Enter your ${selectedChoice?.credentialLabel ?? "credential"}:`
+      )
     );
-    if (!inputName) {
+    if (!credential) {
+      console.log(chalk56.dim("Cancelled"));
       process.exit(0);
     }
-    agentName = inputName;
-  }
-  if (!validateAgentName(agentName)) {
-    ctx.progress.failStep();
-    console.error(
-      chalk56.red(
-        "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
+    const result = await setupModelProvider(providerType, credential);
+    step.detail(
+      chalk56.green(
+        `${providerType} ${result.created ? "created" : "updated"}${result.isDefault ? ` (default for ${result.framework})` : ""}`
       )
     );
-    process.exit(1);
-  }
-  if (existsSync11(agentName)) {
-    ctx.progress.failStep();
-    console.error(chalk56.red(`${agentName}/ already exists`));
-    console.log();
-    console.log("Remove it first or choose a different name:");
-    console.log(chalk56.cyan(`  rm -rf ${agentName}`));
-    process.exit(1);
-  }
-  await mkdir7(agentName, { recursive: true });
-  ctx.progress.detail(`Created ${agentName}/`);
-  ctx.progress.completeStep();
+  });
+}
+async function handleAgentCreation(ctx) {
+  let agentName = ctx.options.name ?? DEFAULT_AGENT_NAME;
+  await ctx.runner.step("Create New Project", async (step) => {
+    if (!ctx.options.yes && !ctx.options.name && ctx.interactive) {
+      let folderExists = true;
+      while (folderExists) {
+        step.connector();
+        const inputName = await step.prompt(
+          () => promptText(
+            "Enter project name:",
+            DEFAULT_AGENT_NAME,
+            (value) => {
+              if (!validateAgentName(value)) {
+                return "Invalid name: 3-64 chars, alphanumeric + hyphens, start/end with letter/number";
+              }
+              return true;
+            }
+          )
+        );
+        if (!inputName) {
+          process.exit(0);
+        }
+        agentName = inputName;
+        if (existsSync11(agentName)) {
+          step.detail(
+            chalk56.yellow(`${agentName}/ already exists, choose another name`)
+          );
+        } else {
+          folderExists = false;
+        }
+      }
+    } else {
+      if (!validateAgentName(agentName)) {
+        console.error(
+          chalk56.red(
+            "Invalid agent name: must be 3-64 chars, alphanumeric + hyphens"
+          )
+        );
+        process.exit(1);
+      }
+      if (existsSync11(agentName)) {
+        console.error(chalk56.red(`${agentName}/ already exists`));
+        console.log();
+        console.log("Remove it first or choose a different name:");
+        console.log(chalk56.cyan(`  rm -rf ${agentName}`));
+        process.exit(1);
+      }
+    }
+    await mkdir7(agentName, { recursive: true });
+    step.detail(chalk56.green(`Created ${agentName}/`));
+  });
   return agentName;
 }
 async function handlePluginInstallation(ctx, agentName) {
-  ctx.progress.startStep("Claude Plugin Install");
-  let shouldInstall = true;
-  if (!ctx.options.yes && ctx.interactive) {
-    const confirmed = await promptConfirm(
-      "Install VM0 Claude Plugin?",
-      true
-      // default: Yes
-    );
-    shouldInstall = confirmed ?? true;
-  }
-  if (!shouldInstall) {
-    ctx.progress.detail("Skipped");
-    ctx.progress.completeStep();
-    return;
-  }
-  const scope = "project";
-  try {
-    const agentDir = path16.resolve(process.cwd(), agentName);
-    const result = await installVm0Plugin(scope, agentDir);
-    ctx.progress.detail(
-      `Installed ${result.pluginId} (scope: ${result.scope})`
-    );
-  } catch (error) {
-    handlePluginError(error);
-  }
-  ctx.progress.completeStep();
+  let pluginInstalled = false;
+  await ctx.runner.step("Install Claude Plugin", async (step) => {
+    let shouldInstall = true;
+    if (!ctx.options.yes && ctx.interactive) {
+      step.connector();
+      const confirmed = await step.prompt(
+        () => promptConfirm("Install VM0 Claude Plugin?", true)
+      );
+      shouldInstall = confirmed ?? true;
+    }
+    if (!shouldInstall) {
+      step.detail(chalk56.dim("Skipped"));
+      return;
+    }
+    const scope = "project";
+    try {
+      const agentDir = `${process.cwd()}/${agentName}`;
+      const result = await installVm0Plugin(scope, agentDir);
+      step.detail(
+        chalk56.green(`Installed ${result.pluginId} (scope: ${result.scope})`)
+      );
+      pluginInstalled = true;
+    } catch (error) {
+      handlePluginError(error);
+    }
+  });
+  return pluginInstalled;
 }
-function printNextSteps(agentName) {
+function printNextSteps(agentName, pluginInstalled) {
   console.log();
   console.log(chalk56.bold("Next step:"));
   console.log();
-  console.log(
-    `  ${chalk56.cyan(`cd ${agentName} && claude "/${PRIMARY_SKILL_NAME} let's build a workflow"`)}`
-  );
+  if (pluginInstalled) {
+    console.log(
+      `  ${chalk56.cyan(`cd ${agentName} && claude "/${PRIMARY_SKILL_NAME} let's build an agent"`)}`
+    );
+  } else {
+    console.log(`  ${chalk56.cyan(`cd ${agentName} && vm0 init`)}`);
+  }
   console.log();
 }
 var onboardCommand = new Command56().name("onboard").description("Guided setup for new VM0 users").option("-y, --yes", "Skip confirmation prompts").option("--name <name>", `Agent name (default: ${DEFAULT_AGENT_NAME})`).action(async (options) => {
   const interactive = isInteractive();
   if (interactive) {
+    process.stdout.write("\x1B[2J\x1B[H");
     console.log();
     renderOnboardWelcome();
     console.log();
   }
-  const progress = createProgressiveProgress(interactive);
-  const ctx = { interactive, options, progress };
+  const runner = createStepRunner({
+    interactive,
+    header: interactive ? renderOnboardWelcome : void 0
+  });
+  const ctx = { interactive, options, runner };
   await handleAuthentication(ctx);
   await handleModelProvider(ctx);
   const agentName = await handleAgentCreation(ctx);
-  await handlePluginInstallation(ctx, agentName);
-  progress.startStep("Complete");
-  progress.setFinalStep();
-  progress.completeStep();
-  printNextSteps(agentName);
+  const pluginInstalled = await handlePluginInstallation(ctx, agentName);
+  await ctx.runner.finalStep("Completed", async () => {
+  });
+  printNextSteps(agentName, pluginInstalled);
 });
 
 // src/commands/setup-claude/index.ts
@@ -11281,7 +11315,7 @@ var setupClaudeCommand = new Command57().name("setup-claude").description("Insta
 
 // src/index.ts
 var program = new Command58();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.5.0");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.6.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "9.5.0",
+  "version": "9.6.0",
   "description": "CLI application",
   "repository": {
     "type": "git",