@vm0/cli 8.1.1 → 9.1.0

package/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command45 } from "commander";
-import chalk46 from "chalk";
+import { Command as Command47 } from "commander";
+import chalk48 from "chalk";
 
 // src/lib/api/auth.ts
 import chalk from "chalk";
@@ -86,7 +86,7 @@ async function authenticate(apiUrl) {
   console.log("Initiating authentication...");
   const deviceAuth = await requestDeviceCode(targetApiUrl);
   console.log(chalk.green("\nDevice code generated"));
-  const verificationUrl = `${targetApiUrl}/cli-auth`;
+  const verificationUrl = `${targetApiUrl}${deviceAuth.verification_path}`;
   console.log(chalk.cyan(`
 To authenticate, visit: ${verificationUrl}`));
   console.log(`And enter this code: ${chalk.bold(deviceAuth.user_code)}`);
@@ -1483,7 +1483,7 @@ var cliAuthDeviceContract = c6.router({
       200: z8.object({
         device_code: z8.string(),
         user_code: z8.string(),
-        verification_url: z8.string(),
+        verification_path: z8.string(),
         expires_in: z8.number(),
         interval: z8.number()
       }),
@@ -2305,12 +2305,12 @@ var publicApiErrorSchema = z18.object({
     code: z18.string(),
     message: z18.string(),
     param: z18.string().optional(),
-    doc_url: z18.string().url().optional()
+    docUrl: z18.string().url().optional()
   })
 });
 var paginationSchema = z18.object({
-  has_more: z18.boolean(),
-  next_cursor: z18.string().nullable()
+  hasMore: z18.boolean(),
+  nextCursor: z18.string().nullable()
 });
 function createPaginatedResponseSchema(dataSchema) {
   return z18.object({
@@ -2327,6 +2327,11 @@ var timestampSchema = z18.string().datetime();
 
 // ../../packages/core/src/contracts/platform.ts
 var c15 = initContract();
+var platformPaginationSchema = z19.object({
+  hasMore: z19.boolean(),
+  nextCursor: z19.string().nullable(),
+  totalPages: z19.number()
+});
 var platformLogStatusSchema = z19.enum([
   "pending",
   "running",
@@ -2338,9 +2343,10 @@ var platformLogStatusSchema = z19.enum([
 var platformLogEntrySchema = z19.object({
   id: z19.string().uuid()
 });
-var platformLogsListResponseSchema = createPaginatedResponseSchema(
-  platformLogEntrySchema
-);
+var platformLogsListResponseSchema = z19.object({
+  data: z19.array(platformLogEntrySchema),
+  pagination: platformPaginationSchema
+});
 var artifactSchema = z19.object({
   name: z19.string().nullable(),
   version: z19.string().nullable()
@@ -2349,7 +2355,7 @@ var platformLogDetailSchema = z19.object({
   id: z19.string().uuid(),
   sessionId: z19.string().nullable(),
   agentName: z19.string(),
-  provider: z19.string(),
+  framework: z19.string().nullable(),
   status: platformLogStatusSchema,
   prompt: z19.string(),
   error: z19.string().nullable(),
@@ -2387,6 +2393,26 @@ var platformLogsByIdContract = c15.router({
     summary: "Get agent run log details by ID"
   }
 });
+var artifactDownloadResponseSchema = z19.object({
+  url: z19.string().url(),
+  expiresAt: z19.string()
+});
+var platformArtifactDownloadContract = c15.router({
+  getDownloadUrl: {
+    method: "GET",
+    path: "/api/platform/artifacts/download",
+    query: z19.object({
+      name: z19.string().min(1, "Artifact name is required"),
+      version: z19.string().optional()
+    }),
+    responses: {
+      200: artifactDownloadResponseSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema
+    },
+    summary: "Get presigned URL for artifact download"
+  }
+});
 
 // ../../packages/core/src/contracts/public/agents.ts
 import { z as z20 } from "zod";
@@ -2394,15 +2420,15 @@ var c16 = initContract();
 var publicAgentSchema = z20.object({
   id: z20.string(),
   name: z20.string(),
-  current_version_id: z20.string().nullable(),
-  created_at: timestampSchema,
-  updated_at: timestampSchema
+  currentVersionId: z20.string().nullable(),
+  createdAt: timestampSchema,
+  updatedAt: timestampSchema
 });
 var agentVersionSchema = z20.object({
   id: z20.string(),
-  agent_id: z20.string(),
-  version_number: z20.number(),
-  created_at: timestampSchema
+  agentId: z20.string(),
+  versionNumber: z20.number(),
+  createdAt: timestampSchema
 });
 var publicAgentDetailSchema = publicAgentSchema;
 var paginatedAgentsSchema = createPaginatedResponseSchema(publicAgentSchema);
@@ -2476,50 +2502,50 @@ var publicRunStatusSchema = z21.enum([
 ]);
 var publicRunSchema = z21.object({
   id: z21.string(),
-  agent_id: z21.string(),
-  agent_name: z21.string(),
+  agentId: z21.string(),
+  agentName: z21.string(),
   status: publicRunStatusSchema,
   prompt: z21.string(),
-  created_at: timestampSchema,
-  started_at: timestampSchema.nullable(),
-  completed_at: timestampSchema.nullable()
+  createdAt: timestampSchema,
+  startedAt: timestampSchema.nullable(),
+  completedAt: timestampSchema.nullable()
 });
 var publicRunDetailSchema = publicRunSchema.extend({
   error: z21.string().nullable(),
-  execution_time_ms: z21.number().nullable(),
-  checkpoint_id: z21.string().nullable(),
-  session_id: z21.string().nullable(),
-  artifact_name: z21.string().nullable(),
-  artifact_version: z21.string().nullable(),
+  executionTimeMs: z21.number().nullable(),
+  checkpointId: z21.string().nullable(),
+  sessionId: z21.string().nullable(),
+  artifactName: z21.string().nullable(),
+  artifactVersion: z21.string().nullable(),
   volumes: z21.record(z21.string(), z21.string()).optional()
 });
 var paginatedRunsSchema = createPaginatedResponseSchema(publicRunSchema);
 var createRunRequestSchema = z21.object({
-  // Agent identification (one of: agent, agent_id, session_id, checkpoint_id)
+  // Agent identification (one of: agent, agentId, sessionId, checkpointId)
   agent: z21.string().optional(),
   // Agent name
-  agent_id: z21.string().optional(),
+  agentId: z21.string().optional(),
   // Agent ID
-  agent_version: z21.string().optional(),
+  agentVersion: z21.string().optional(),
   // Version specifier (e.g., "latest", "v1", specific ID)
   // Continue session
-  session_id: z21.string().optional(),
+  sessionId: z21.string().optional(),
   // Resume from checkpoint
-  checkpoint_id: z21.string().optional(),
+  checkpointId: z21.string().optional(),
   // Required
   prompt: z21.string().min(1, "Prompt is required"),
   // Optional configuration
   variables: z21.record(z21.string(), z21.string()).optional(),
   secrets: z21.record(z21.string(), z21.string()).optional(),
-  artifact_name: z21.string().optional(),
+  artifactName: z21.string().optional(),
   // Artifact name to mount
-  artifact_version: z21.string().optional(),
+  artifactVersion: z21.string().optional(),
   // Artifact version (defaults to latest)
   volumes: z21.record(z21.string(), z21.string()).optional()
   // volume_name -> version
 });
 var runListQuerySchema = listQuerySchema.extend({
-  agent_id: z21.string().optional(),
+  agentId: z21.string().optional(),
   status: publicRunStatusSchema.optional(),
   since: timestampSchema.optional()
 });
@@ -2628,16 +2654,16 @@ var publicRunLogsContract = c17.router({
 });
 var metricPointSchema = z21.object({
   timestamp: timestampSchema,
-  cpu_percent: z21.number(),
-  memory_used_mb: z21.number(),
-  memory_total_mb: z21.number(),
-  disk_used_mb: z21.number(),
-  disk_total_mb: z21.number()
+  cpuPercent: z21.number(),
+  memoryUsedMb: z21.number(),
+  memoryTotalMb: z21.number(),
+  diskUsedMb: z21.number(),
+  diskTotalMb: z21.number()
 });
 var metricsSummarySchema = z21.object({
-  avg_cpu_percent: z21.number(),
-  max_memory_used_mb: z21.number(),
-  total_duration_ms: z21.number().nullable()
+  avgCpuPercent: z21.number(),
+  maxMemoryUsedMb: z21.number(),
+  totalDurationMs: z21.number().nullable()
 });
 var metricsResponseSchema2 = z21.object({
   data: z21.array(metricPointSchema),
@@ -2688,7 +2714,7 @@ var publicRunEventsContract = c17.router({
       id: z21.string().min(1, "Run ID is required")
     }),
     query: z21.object({
-      last_event_id: z21.string().optional()
+      lastEventId: z21.string().optional()
       // For reconnection
     }),
     responses: {
@@ -2709,27 +2735,27 @@ var c18 = initContract();
 var publicArtifactSchema = z22.object({
   id: z22.string(),
   name: z22.string(),
-  current_version_id: z22.string().nullable(),
+  currentVersionId: z22.string().nullable(),
   size: z22.number(),
   // Total size in bytes
-  file_count: z22.number(),
-  created_at: timestampSchema,
-  updated_at: timestampSchema
+  fileCount: z22.number(),
+  createdAt: timestampSchema,
+  updatedAt: timestampSchema
 });
 var artifactVersionSchema = z22.object({
   id: z22.string(),
   // SHA-256 content hash
-  artifact_id: z22.string(),
+  artifactId: z22.string(),
   size: z22.number(),
   // Size in bytes
-  file_count: z22.number(),
+  fileCount: z22.number(),
   message: z22.string().nullable(),
   // Optional commit message
-  created_by: z22.string(),
-  created_at: timestampSchema
+  createdBy: z22.string(),
+  createdAt: timestampSchema
 });
 var publicArtifactDetailSchema = publicArtifactSchema.extend({
-  current_version: artifactVersionSchema.nullable()
+  currentVersion: artifactVersionSchema.nullable()
 });
 var paginatedArtifactsSchema = createPaginatedResponseSchema(publicArtifactSchema);
 var paginatedArtifactVersionsSchema = createPaginatedResponseSchema(
@@ -2796,7 +2822,7 @@ var publicArtifactDownloadContract = c18.router({
       id: z22.string().min(1, "Artifact ID is required")
     }),
     query: z22.object({
-      version_id: z22.string().optional()
+      versionId: z22.string().optional()
       // Defaults to current version
     }),
     responses: {
@@ -2817,27 +2843,27 @@ var c19 = initContract();
 var publicVolumeSchema = z23.object({
   id: z23.string(),
   name: z23.string(),
-  current_version_id: z23.string().nullable(),
+  currentVersionId: z23.string().nullable(),
   size: z23.number(),
   // Total size in bytes
-  file_count: z23.number(),
-  created_at: timestampSchema,
-  updated_at: timestampSchema
+  fileCount: z23.number(),
+  createdAt: timestampSchema,
+  updatedAt: timestampSchema
 });
 var volumeVersionSchema = z23.object({
   id: z23.string(),
   // SHA-256 content hash
-  volume_id: z23.string(),
+  volumeId: z23.string(),
   size: z23.number(),
   // Size in bytes
-  file_count: z23.number(),
+  fileCount: z23.number(),
   message: z23.string().nullable(),
   // Optional commit message
-  created_by: z23.string(),
-  created_at: timestampSchema
+  createdBy: z23.string(),
+  createdAt: timestampSchema
 });
 var publicVolumeDetailSchema = publicVolumeSchema.extend({
-  current_version: volumeVersionSchema.nullable()
+  currentVersion: volumeVersionSchema.nullable()
 });
 var paginatedVolumesSchema = createPaginatedResponseSchema(publicVolumeSchema);
 var paginatedVolumeVersionsSchema = createPaginatedResponseSchema(volumeVersionSchema);
@@ -2902,7 +2928,7 @@ var publicVolumeDownloadContract = c19.router({
       id: z23.string().min(1, "Volume ID is required")
     }),
     query: z23.object({
-      version_id: z23.string().optional()
+      versionId: z23.string().optional()
       // Defaults to current version
     }),
     responses: {
@@ -3094,10 +3120,10 @@ async function getRawHeaders() {
   }
   return headers;
 }
-async function httpGet(path14) {
+async function httpGet(path15) {
   const baseUrl = await getBaseUrl();
   const headers = await getRawHeaders();
-  return fetch(`${baseUrl}${path14}`, {
+  return fetch(`${baseUrl}${path15}`, {
     method: "GET",
     headers
   });
@@ -3577,49 +3603,49 @@ var cliComposeSchema = z24.object({
 function formatZodError(error) {
   const issue = error.issues[0];
   if (!issue) return "Validation failed";
-  const path14 = issue.path.join(".");
+  const path15 = issue.path.join(".");
   const message = issue.message;
-  if (!path14) return message;
+  if (!path15) return message;
   if (issue.code === "invalid_type") {
     const received = issue.received;
     const isMissing = received === "undefined" || message.includes("received undefined") || message === "Required";
-    if (path14 === "version" && isMissing) {
+    if (path15 === "version" && isMissing) {
       return "Missing config.version";
     }
-    if (path14 === "agents" && isMissing) {
+    if (path15 === "agents" && isMissing) {
       return "Missing agents object in config";
     }
-    if (path14.startsWith("volumes.") && path14.endsWith(".name")) {
-      const volumeKey = path14.split(".")[1];
+    if (path15.startsWith("volumes.") && path15.endsWith(".name")) {
+      const volumeKey = path15.split(".")[1];
       return `Volume "${volumeKey}" must have a 'name' field (string)`;
     }
-    if (path14.startsWith("volumes.") && path14.endsWith(".version")) {
-      const volumeKey = path14.split(".")[1];
+    if (path15.startsWith("volumes.") && path15.endsWith(".version")) {
+      const volumeKey = path15.split(".")[1];
       return `Volume "${volumeKey}" must have a 'version' field (string)`;
     }
     if (issue.expected === "array") {
-      const fieldName = path14.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path15.replace(/^agents\.[^.]+\./, "agent.");
       return `${fieldName} must be an array`;
     }
     if (issue.expected === "string" && received === "number") {
-      const fieldName = path14.replace(/^agents\.[^.]+\./, "agent.");
+      const fieldName = path15.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" && path14.startsWith("agents.")) {
+  if (issue.code === "invalid_key" && path15.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" && path14.startsWith("agents.")) {
+  if (message === "Invalid key in record" && path15.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 (path14.startsWith("agents.")) {
-    const cleanPath = path14.replace(/^agents\.[^.]+\./, "agent.");
+  if (path15.startsWith("agents.")) {
+    const cleanPath = path15.replace(/^agents\.[^.]+\./, "agent.");
     if (message.startsWith("Invalid input:")) {
       const match = message.match(/expected (\w+), received (\w+)/);
       if (match && match[1] === "string" && match[2] === "number") {
@@ -3631,7 +3657,7 @@ function formatZodError(error) {
     }
     return `${cleanPath}: ${message}`;
   }
-  return `${path14}: ${message}`;
+  return `${path15}: ${message}`;
 }
 function validateAgentName(name) {
   return cliAgentNameSchema.safeParse(name).success;
@@ -5834,7 +5860,7 @@ var ApiClient = class {
   /**
    * Generic GET request
    */
-  async get(path14) {
+  async get(path15) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5847,7 +5873,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path14}`, {
+    return fetch(`${baseUrl}${path15}`, {
       method: "GET",
       headers
     });
@@ -5855,7 +5881,7 @@ var ApiClient = class {
   /**
    * Generic POST request
    */
-  async post(path14, options) {
+  async post(path15, options) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5871,7 +5897,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path14}`, {
+    return fetch(`${baseUrl}${path15}`, {
       method: "POST",
       headers,
       body: options?.body
@@ -5880,7 +5906,7 @@ var ApiClient = class {
   /**
    * Generic DELETE request
    */
-  async delete(path14) {
+  async delete(path15) {
     const baseUrl = await this.getBaseUrl();
     const token = await getToken();
     if (!token) {
@@ -5893,7 +5919,7 @@ var ApiClient = class {
     if (bypassSecret) {
       headers["x-vercel-protection-bypass"] = bypassSecret;
     }
-    return fetch(`${baseUrl}${path14}`, {
+    return fetch(`${baseUrl}${path15}`, {
       method: "DELETE",
       headers
     });
@@ -7888,7 +7914,7 @@ cookCmd.argument("[prompt]", "Prompt for the agent").option(
   // eslint-disable-next-line complexity -- TODO: refactor complex function
   async (prompt, options) => {
     if (!options.noAutoUpdate) {
-      const shouldExit = await checkAndUpgrade("8.1.1", prompt);
+      const shouldExit = await checkAndUpgrade("9.1.0", prompt);
       if (shouldExit) {
         process.exit(0);
       }
@@ -9568,7 +9594,7 @@ Deploying schedule for agent ${chalk32.cyan(params.agentName)}...`
     secrets: expandedSecrets,
     artifactName: params.artifactName
   });
-  displayDeployResult(params.agentName, deployResult);
+  return deployResult;
 }
 function handleSetupError(error) {
   console.error(chalk32.red("\u2717 Failed to setup schedule"));
@@ -9608,14 +9634,53 @@ function displayDeployResult(agentName, deployResult) {
     );
     console.log(chalk32.dim(`  At: ${atTimeFormatted}`));
   }
-  if (deployResult.created) {
-    console.log();
+}
+async function tryEnableSchedule(scheduleName, composeId, agentName) {
+  try {
+    await enableSchedule({ name: scheduleName, composeId });
     console.log(
-      `  To activate: ${chalk32.cyan(`vm0 schedule enable ${agentName}`)}`
+      chalk32.green(`\u2713 Enabled schedule for agent ${chalk32.cyan(agentName)}`)
+    );
+  } catch (error) {
+    console.error(chalk32.yellow("\u26A0 Failed to enable schedule"));
+    if (error instanceof ApiRequestError) {
+      if (error.code === "SCHEDULE_PAST") {
+        console.error(chalk32.dim("  Scheduled time has already passed"));
+      } else {
+        console.error(chalk32.dim(`  ${error.message}`));
+      }
+    } else if (error instanceof Error) {
+      console.error(chalk32.dim(`  ${error.message}`));
+    }
+    console.log(
+      `  To enable manually: ${chalk32.cyan(`vm0 schedule enable ${agentName}`)}`
     );
   }
 }
-var setupCommand = new Command28().name("setup").description("Create or edit a schedule for an agent").argument("<agent-name>", "Agent name to configure schedule for").option("-f, --frequency <type>", "Frequency: daily|weekly|monthly|once").option("-t, --time <HH:MM>", "Time to run (24-hour format)").option("-d, --day <day>", "Day of week (mon-sun) or day of month (1-31)").option("-z, --timezone <tz>", "IANA timezone").option("-p, --prompt <text>", "Prompt to run").option("--var <name=value>", "Variable (can be repeated)", collect, []).option("--secret <name=value>", "Secret (can be repeated)", collect, []).option("--artifact-name <name>", "Artifact name", "artifact").action(async (agentName, options) => {
+function showEnableHint(agentName) {
+  console.log();
+  console.log(`  To enable: ${chalk32.cyan(`vm0 schedule enable ${agentName}`)}`);
+}
+async function handleScheduleEnabling(params) {
+  const { scheduleName, composeId, agentName, enableFlag, shouldPromptEnable } = params;
+  if (enableFlag) {
+    await tryEnableSchedule(scheduleName, composeId, agentName);
+    return;
+  }
+  if (shouldPromptEnable && isInteractive()) {
+    const enableNow = await promptConfirm("Enable this schedule?", true);
+    if (enableNow) {
+      await tryEnableSchedule(scheduleName, composeId, agentName);
+    } else {
+      showEnableHint(agentName);
+    }
+    return;
+  }
+  if (shouldPromptEnable) {
+    showEnableHint(agentName);
+  }
+}
+var setupCommand = new Command28().name("setup").description("Create or edit a schedule for an agent").argument("<agent-name>", "Agent name to configure schedule for").option("-f, --frequency <type>", "Frequency: daily|weekly|monthly|once").option("-t, --time <HH:MM>", "Time to run (24-hour format)").option("-d, --day <day>", "Day of week (mon-sun) or day of month (1-31)").option("-z, --timezone <tz>", "IANA timezone").option("-p, --prompt <text>", "Prompt to run").option("--var <name=value>", "Variable (can be repeated)", collect, []).option("--secret <name=value>", "Secret (can be repeated)", collect, []).option("--artifact-name <name>", "Artifact name", "artifact").option("-e, --enable", "Enable schedule immediately after creation").action(async (agentName, options) => {
   try {
     const { composeId, scheduleName, composeContent } = await resolveAgent(agentName);
     const requiredConfig = extractRequiredConfiguration(composeContent);
@@ -9662,7 +9727,7 @@ var setupCommand = new Command28().name("setup").description("Create or edit a s
       optionVars: options.var || [],
       existingSchedule
     });
-    await buildAndDeploy({
+    const deployResult = await buildAndDeploy({
       scheduleName,
       composeId,
       agentName,
@@ -9676,6 +9741,15 @@ var setupCommand = new Command28().name("setup").description("Create or edit a s
       secrets: config.preserveExistingSecrets ? void 0 : Object.keys(config.secrets).length > 0 ? config.secrets : void 0,
       artifactName: options.artifactName
     });
+    displayDeployResult(agentName, deployResult);
+    const shouldPromptEnable = deployResult.created || existingSchedule !== void 0 && !existingSchedule.enabled;
+    await handleScheduleEnabling({
+      scheduleName,
+      composeId,
+      agentName,
+      enableFlag: options.enable ?? false,
+      shouldPromptEnable
+    });
   } catch (error) {
     handleSetupError(error);
   }
@@ -10555,11 +10629,356 @@ var setDefaultCommand = new Command43().name("set-default").description("Set a m
 // src/commands/model-provider/index.ts
 var modelProviderCommand = new Command44().name("model-provider").description("Manage model providers for agent runs").addCommand(listCommand6).addCommand(setupCommand2).addCommand(deleteCommand3).addCommand(setDefaultCommand);
 
+// src/commands/onboard.ts
+import { Command as Command46 } from "commander";
+import chalk47 from "chalk";
+import prompts3 from "prompts";
+import { mkdir as mkdir8 } from "fs/promises";
+import { existsSync as existsSync10 } from "fs";
+
+// src/commands/setup-claude.ts
+import { Command as Command45 } from "commander";
+import chalk46 from "chalk";
+import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
+import path14 from "path";
+var SKILL_DIR = ".claude/skills/vm0-agent-builder";
+var SKILL_CONTENT = `---
+name: vm0-agent-builder
+description: Guide for building VM0 agents with Claude's help. Use this skill when users want to create or improve their agent's AGENTS.md and vm0.yaml configuration.
+---
+
+# VM0 Agent Builder
+
+Help users create effective AI agents using the VM0 platform. This skill guides the process of designing agent workflows, writing AGENTS.md instructions, and configuring vm0.yaml.
+
+## When to Use
+
+- User wants to create a new VM0 agent from scratch
+- User wants to improve an existing agent's instructions
+- User needs help configuring vm0.yaml with skills
+- User is unsure how to structure their agent's workflow
+
+## Workflow
+
+### Step 1: Understand the Goal
+
+Ask the user what they want their agent to accomplish:
+- What is the main task or problem to solve?
+- What inputs will the agent receive?
+- What outputs should the agent produce?
+- Are there any constraints or requirements?
+
+### Step 2: Design the Workflow
+
+Break down the task into clear, sequential steps:
+1. Each step should be a single, focused action
+2. Steps should build on each other logically
+3. Include error handling and edge cases
+4. Consider what tools/skills the agent will need
+
+### Step 3: Write AGENTS.md
+
+Create the agent instructions file with:
+
+\`\`\`markdown
+# Agent Instructions
+
+You are a [role description].
+
+## Goal
+
+[Clear statement of what the agent should accomplish]
+
+## Workflow
+
+1. [First step with specific instructions]
+2. [Second step with specific instructions]
+3. [Continue with remaining steps...]
+
+## Output
+
+[Describe the expected output format and location]
+
+## Constraints
+
+[Any limitations or rules the agent should follow]
+\`\`\`
+
+### Step 4: Configure vm0.yaml
+
+Update the vm0.yaml to include necessary skills:
+
+\`\`\`yaml
+version: "1.0"
+
+agents:
+  agent-name:
+    framework: claude-code
+    instructions: AGENTS.md
+    skills:
+      - https://github.com/vm0-ai/vm0-skills/tree/main/skill-name
+    environment:
+      # Add any required environment variables
+      API_KEY: "\${{ secrets.API_KEY }}"
+\`\`\`
+
+### Step 5: Test the Agent
+
+Guide the user to test their agent:
+
+\`\`\`bash
+# Deploy the agent configuration
+vm0 compose vm0.yaml
+
+# Run the agent with a test prompt
+vm0 cook "start working on the task"
+
+# Check the logs if needed
+vm0 logs <run-id>
+\`\`\`
+
+## Available Skills
+
+Common skills from vm0-skills repository:
+
+| Skill | Purpose |
+|-------|---------|
+| \`github\` | GitHub API operations (issues, PRs, repos) |
+| \`slack\` | Send messages to Slack channels |
+| \`notion\` | Read/write Notion pages and databases |
+| \`firecrawl\` | Web scraping and content extraction |
+| \`browserbase\` | Browser automation |
+| \`openai\` | OpenAI API for embeddings, completions |
+| \`supabase\` | Database operations with Supabase |
+
+Browse all skills: https://github.com/vm0-ai/vm0-skills
+
+## Example Agents
+
+### Content Curator Agent
+
+\`\`\`markdown
+# Agent Instructions
+
+You are a content curator that monitors HackerNews for AI-related articles.
+
+## Workflow
+
+1. Go to HackerNews and read the top 30 stories
+2. Filter for AI, ML, and LLM related content
+3. For each relevant article, extract:
+   - Title and URL
+   - Key points (2-3 sentences)
+   - Why it's interesting
+4. Write a summary to \`daily-digest.md\`
+
+## Output
+
+Create \`daily-digest.md\` with today's date as the header.
+\`\`\`
+
+### GitHub Issue Tracker Agent
+
+\`\`\`markdown
+# Agent Instructions
+
+You are a GitHub issue tracker that summarizes open issues.
+
+## Workflow
+
+1. List all open issues in the repository
+2. Group issues by labels (bug, feature, docs)
+3. For each group, summarize:
+   - Number of issues
+   - Oldest issue age
+   - Most discussed issues
+4. Create a report in \`issue-report.md\`
+
+## Skills Required
+
+- github (for API access)
+\`\`\`
+
+### Data Pipeline Agent
+
+\`\`\`markdown
+# Agent Instructions
+
+You are a data pipeline agent that processes CSV files.
+
+## Workflow
+
+1. Read all CSV files from the input volume
+2. For each file:
+   - Validate the schema
+   - Clean missing values
+   - Transform dates to ISO format
+3. Merge all files into \`combined.csv\`
+4. Generate a summary report
+
+## Input
+
+Files are provided via volume mount.
+
+## Output
+
+Write results to the artifact directory.
+\`\`\`
+
+## Best Practices
+
+1. **Be Specific**: Vague instructions lead to unpredictable results
+2. **One Task Per Step**: Keep workflow steps focused and atomic
+3. **Define Output Clearly**: Specify exact file names and formats
+4. **Handle Errors**: Include what to do when things go wrong
+5. **Test Incrementally**: Start with simple workflows, add complexity
+6. **Use Skills Wisely**: Only include skills the agent actually needs
+
+## Troubleshooting
+
+### Agent doesn't follow instructions
+- Make instructions more specific and explicit
+- Add examples of expected behavior
+- Break complex steps into smaller sub-steps
+
+### Agent uses wrong tools
+- Specify which tools/skills to use for each step
+- Add constraints about what NOT to do
+
+### Output format is wrong
+- Provide exact templates for output files
+- Include example output in the instructions
+`;
+var setupClaudeCommand = new Command45().name("setup-claude").description("Add/update Claude skill for agent building").action(async () => {
+  console.log(chalk46.dim("Installing vm0-agent-builder skill..."));
+  await mkdir7(SKILL_DIR, { recursive: true });
+  await writeFile7(path14.join(SKILL_DIR, "SKILL.md"), SKILL_CONTENT);
+  console.log(
+    chalk46.green(`Done Installed vm0-agent-builder skill to ${SKILL_DIR}`)
+  );
+  console.log();
+  console.log("Next step:");
+  console.log(
+    chalk46.cyan(
+      '  claude /vm0-agent-builder "I want to build an agent that..."'
+    )
+  );
+});
+
+// src/commands/onboard.ts
+var DEMO_AGENT_DIR = "vm0-demo-agent";
+var DEMO_AGENT_NAME = "vm0-demo-agent";
+var onboardCommand = new Command46().name("onboard").description("Guided setup for new VM0 users").option("-y, --yes", "Skip confirmation prompts").option(
+  "--method <method>",
+  "Agent building method: claude or manual",
+  void 0
+).action(async (options) => {
+  const token = await getToken();
+  if (token) {
+    console.log(chalk47.green("Done Authenticated"));
+  } else {
+    console.log(chalk47.dim("Authentication required..."));
+    console.log();
+    await authenticate();
+  }
+  try {
+    const result = await listModelProviders();
+    if (result.modelProviders.length > 0) {
+      console.log(chalk47.green("Done Model provider configured"));
+    } else {
+      console.log(chalk47.yellow("! No model provider configured"));
+      console.log();
+      console.log("Run the following to set up:");
+      console.log(chalk47.cyan("  vm0 model-provider setup"));
+      console.log();
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.log(
+      chalk47.yellow(`! Could not check model provider status: ${message}`)
+    );
+    console.log();
+  }
+  let createAgent = options.yes;
+  if (!createAgent && isInteractive()) {
+    const response = await prompts3(
+      {
+        type: "confirm",
+        name: "create",
+        message: `Create ${DEMO_AGENT_DIR}?`,
+        initial: true
+      },
+      { onCancel: () => process.exit(0) }
+    );
+    createAgent = response.create;
+  }
+  if (!createAgent) {
+    console.log(chalk47.dim("Skipped agent creation"));
+    return;
+  }
+  if (existsSync10(DEMO_AGENT_DIR)) {
+    console.log(chalk47.red(`x ${DEMO_AGENT_DIR}/ already exists`));
+    console.log();
+    console.log("Remove it first or use a different directory:");
+    console.log(chalk47.cyan(`  rm -rf ${DEMO_AGENT_DIR}`));
+    process.exit(1);
+  }
+  await mkdir8(DEMO_AGENT_DIR, { recursive: true });
+  const originalDir = process.cwd();
+  process.chdir(DEMO_AGENT_DIR);
+  try {
+    await initCommand3.parseAsync(["--name", DEMO_AGENT_NAME], {
+      from: "user"
+    });
+  } finally {
+    process.chdir(originalDir);
+  }
+  console.log();
+  let method = options.method;
+  if (!method && isInteractive()) {
+    const response = await prompts3(
+      {
+        type: "select",
+        name: "method",
+        message: "How would you like to build your agent?",
+        choices: [
+          {
+            title: "Use `vm0 setup-claude` to let Claude help (Recommended)",
+            value: "claude"
+          },
+          {
+            title: "I will do it myself (Edit `AGENTS.md` and `vm0.yaml`)",
+            value: "manual"
+          }
+        ]
+      },
+      { onCancel: () => process.exit(0) }
+    );
+    method = response.method;
+  }
+  if (method === "claude") {
+    process.chdir(DEMO_AGENT_DIR);
+    try {
+      await setupClaudeCommand.parseAsync([], { from: "user" });
+    } finally {
+      process.chdir(originalDir);
+    }
+  } else {
+    console.log("Next steps:");
+    console.log(`  1. ${chalk47.cyan(`cd ${DEMO_AGENT_DIR}`)}`);
+    console.log(
+      `  2. Edit ${chalk47.cyan("AGENTS.md")} to define your agent's workflow`
+    );
+    console.log(`  3. Edit ${chalk47.cyan("vm0.yaml")} to configure skills`);
+    console.log(`  4. Run ${chalk47.cyan('vm0 cook "start working"')} to test`);
+  }
+});
+
 // src/index.ts
-var program = new Command45();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("8.1.1");
+var program = new Command47();
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.1.0");
 program.command("info").description("Display environment information").action(async () => {
-  console.log(chalk46.bold("System Information:"));
+  console.log(chalk48.bold("System Information:"));
   console.log(`Node Version: ${process.version}`);
   console.log(`Platform: ${process.platform}`);
   console.log(`Architecture: ${process.arch}`);
@@ -10592,6 +11011,8 @@ program.addCommand(scheduleCommand);
 program.addCommand(usageCommand);
 program.addCommand(credentialCommand);
 program.addCommand(modelProviderCommand);
+program.addCommand(onboardCommand);
+program.addCommand(setupClaudeCommand);
 if (process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("vm0")) {
   program.parse();
 }

package/package.json

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