@vellumai/cli 0.4.25 → 0.4.29

package/src/commands/hatch.ts

@@ -1,5 +1,15 @@
 import { createHash, randomBytes, randomUUID } from "crypto";
-import { appendFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, symlinkSync, unlinkSync, writeFileSync } from "fs";
+import {
+  appendFileSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  readlinkSync,
+  symlinkSync,
+  unlinkSync,
+  writeFileSync,
+} from "fs";
 import { homedir, hostname, userInfo } from "os";
 import { join } from "path";
 
@@ -10,7 +20,11 @@ import qrcode from "qrcode-terminal";
 import cliPkg from "../../package.json";
 
 import { buildOpenclawStartupScript } from "../adapters/openclaw";
-import { loadAllAssistants, saveAssistantEntry, syncConfigToLockfile } from "../lib/assistant-config";
+import {
+  loadAllAssistants,
+  saveAssistantEntry,
+  syncConfigToLockfile,
+} from "../lib/assistant-config";
 import type { AssistantEntry } from "../lib/assistant-config";
 import { hatchAws } from "../lib/aws";
 import {
@@ -22,7 +36,12 @@ import {
 import type { RemoteHost, Species } from "../lib/constants";
 import { hatchGcp } from "../lib/gcp";
 import type { PollResult, WatchHatchingResult } from "../lib/gcp";
-import { startLocalDaemon, startGateway, stopLocalProcesses } from "../lib/local";
+import {
+  startLocalDaemon,
+  startGateway,
+  startOutboundProxy,
+  stopLocalProcesses,
+} from "../lib/local";
 import { probePort } from "../lib/port-probe";
 import { isProcessAlive } from "../lib/process";
 import { generateRandomSuffix } from "../lib/random-name";
@@ -32,14 +51,13 @@ export type { PollResult, WatchHatchingResult } from "../lib/gcp";
 
 const INSTALL_SCRIPT_REMOTE_PATH = "/tmp/vellum-install.sh";
 
-
 const HATCH_TIMEOUT_MS: Record<Species, number> = {
   vellum: 2 * 60 * 1000,
   openclaw: 10 * 60 * 1000,
 };
 const DEFAULT_SPECIES: Species = "vellum";
 
-const SPINNER_FRAMES= ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
 const IS_DESKTOP = !!process.env.VELLUM_DESKTOP_APP;
 
@@ -77,9 +95,14 @@ export async function buildStartupScript(
   instanceName: string,
   cloud: RemoteHost,
 ): Promise<string> {
-  const platformUrl = process.env.VELLUM_ASSISTANT_PLATFORM_URL ?? "https://assistant.vellum.ai";
-  const logPath = cloud === "custom" ? "/tmp/vellum-startup.log" : "/var/log/startup-script.log";
-  const errorPath = cloud === "custom" ? "/tmp/vellum-startup-error" : "/var/log/startup-error";
+  const platformUrl =
+    process.env.VELLUM_ASSISTANT_PLATFORM_URL ?? "https://assistant.vellum.ai";
+  const logPath =
+    cloud === "custom"
+      ? "/tmp/vellum-startup.log"
+      : "/var/log/startup-script.log";
+  const errorPath =
+    cloud === "custom" ? "/tmp/vellum-startup-error" : "/var/log/startup-error";
   const timestampRedirect = buildTimestampRedirect(logPath);
   const userSetup = buildUserSetup(sshUser);
   const ownershipFixup = buildOwnershipFixup();
@@ -174,10 +197,18 @@ function parseArgs(): HatchArgs {
       console.log("Options:");
       console.log("  -d                        Run in detached mode");
       console.log("  --name <name>             Custom instance name");
-      console.log("  --remote <host>           Remote host (local, gcp, aws, custom)");
-      console.log("  --daemon-only             Start daemon only, skip gateway");
-      console.log("  --restart                 Restart processes without onboarding side effects");
-      console.log("  --watch                   Run daemon and gateway in watch mode (hot reload on source changes)");
+      console.log(
+        "  --remote <host>           Remote host (local, gcp, aws, custom)",
+      );
+      console.log(
+        "  --daemon-only             Start assistant only, skip gateway",
+      );
+      console.log(
+        "  --restart                 Restart processes without onboarding side effects",
+      );
+      console.log(
+        "  --watch                   Run assistant and gateway in watch mode (hot reload on source changes)",
+      );
       process.exit(0);
     } else if (arg === "-d") {
       detached = true;
@@ -196,7 +227,9 @@ function parseArgs(): HatchArgs {
       try {
         validateAssistantName(next);
       } catch {
-        console.error(`Error: --name contains invalid characters (path separators or traversal segments are not allowed)`);
+        console.error(
+          `Error: --name contains invalid characters (path separators or traversal segments are not allowed)`,
+        );
         process.exit(1);
       }
       name = next;
@@ -236,7 +269,11 @@ function pickMessage(messages: string[], elapsedMs: number): string {
   return messages[idx];
 }
 
-function getPhaseIcon(hasLogs: boolean, elapsedMs: number, species: Species): string {
+function getPhaseIcon(
+  hasLogs: boolean,
+  elapsedMs: number,
+  species: Species,
+): string {
   if (!hasLogs) {
     return elapsedMs < 30000 ? "🥚" : "🪺";
   }
@@ -292,7 +329,11 @@ export async function watchHatching(
         : pickMessage(config.waitingMessages, elapsed);
     spinnerIdx++;
 
-    const lines = ["", `   ${icon} ${spinner}  ${message}  ⏱  ${formatElapsed(elapsed)}`, ""];
+    const lines = [
+      "",
+      `   ${icon} ${spinner}  ${message}  ⏱  ${formatElapsed(elapsed)}`,
+      "",
+    ];
 
     for (const line of lines) {
       process.stdout.write(`\x1b[K${line}\n`);
@@ -334,7 +375,9 @@ export async function watchHatching(
       if (elapsed >= HATCH_TIMEOUT_MS[species]) {
         clearInterval(interval);
         console.log("");
-        console.log(`   ⏰ Timed out after ${formatElapsed(elapsed)}. Instance is still running.`);
+        console.log(
+          `   ⏰ Timed out after ${formatElapsed(elapsed)}. Instance is still running.`,
+        );
         console.log(`   Monitor with: vel logs ${instanceName}`);
         console.log("");
         resolve({ success: true, errorContent: lastErrorContent });
@@ -378,7 +421,9 @@ function watchHatchingDesktop(
 
       if (elapsed >= HATCH_TIMEOUT_MS[species]) {
         clearInterval(interval);
-        desktopLog(`Timed out after ${formatElapsed(elapsed)}. Instance is still running.`);
+        desktopLog(
+          `Timed out after ${formatElapsed(elapsed)}. Instance is still running.`,
+        );
         desktopLog(`Monitor with: vel logs ${instanceName}`);
         resolve({ success: true, errorContent: lastErrorContent });
         return;
@@ -474,7 +519,9 @@ function ensureLocalBinInShellProfile(localBinDir: string): void {
   if (!profilePath) return;
 
   try {
-    const contents = existsSync(profilePath) ? readFileSync(profilePath, "utf-8") : "";
+    const contents = existsSync(profilePath)
+      ? readFileSync(profilePath, "utf-8")
+      : "";
     // Check if ~/.local/bin is already referenced in PATH exports
     if (contents.includes(localBinDir)) return;
     const line = `\nexport PATH="${localBinDir}:\$PATH"\n`;
@@ -506,10 +553,16 @@ function installCLISymlink(): void {
     return;
   }
 
-  console.log(`   ⚠ Could not create symlink for vellum CLI (tried ${preferredPath} and ${fallbackPath})`);
+  console.log(
+    `   ⚠ Could not create symlink for vellum CLI (tried ${preferredPath} and ${fallbackPath})`,
+  );
 }
 
-async function waitForDaemonReady(runtimeUrl: string, bearerToken: string | undefined, timeoutMs = 15000): Promise<boolean> {
+async function waitForDaemonReady(
+  runtimeUrl: string,
+  bearerToken: string | undefined,
+  timeoutMs = 15000,
+): Promise<boolean> {
   const start = Date.now();
   const pollInterval = 1000;
   while (Date.now() - start < timeoutMs) {
@@ -528,7 +581,10 @@ async function waitForDaemonReady(runtimeUrl: string, bearerToken: string | unde
   return false;
 }
 
-async function displayPairingQRCode(runtimeUrl: string, bearerToken: string | undefined): Promise<void> {
+async function displayPairingQRCode(
+  runtimeUrl: string,
+  bearerToken: string | undefined,
+): Promise<void> {
   try {
     const pairingRequestId = randomUUID();
     const pairingSecret = randomBytes(32).toString("hex");
@@ -539,7 +595,9 @@ async function displayPairingQRCode(runtimeUrl: string, bearerToken: string | un
     // health endpoint through the gateway to ensure it's reachable.
     const daemonReady = await waitForDaemonReady(runtimeUrl, bearerToken);
     if (!daemonReady) {
-      console.warn("⚠ Daemon health check did not pass within 15s. Run `vellum pair` to try again.\n");
+      console.warn(
+        "⚠ Assistant health check did not pass within 15s. Run `vellum pair` to try again.\n",
+      );
       return;
     }
 
@@ -549,16 +607,24 @@ async function displayPairingQRCode(runtimeUrl: string, bearerToken: string | un
         "Content-Type": "application/json",
         ...(bearerToken ? { Authorization: `Bearer ${bearerToken}` } : {}),
       },
-      body: JSON.stringify({ pairingRequestId, pairingSecret, gatewayUrl: runtimeUrl }),
+      body: JSON.stringify({
+        pairingRequestId,
+        pairingSecret,
+        gatewayUrl: runtimeUrl,
+      }),
     });
 
     if (!registerRes.ok) {
       const body = await registerRes.text().catch(() => "");
-      console.warn(`⚠ Could not register pairing request: ${registerRes.status} ${registerRes.statusText}${body ? ` — ${body}` : ""}. Run \`vellum pair\` to try again.\n`);
+      console.warn(
+        `⚠ Could not register pairing request: ${registerRes.status} ${registerRes.statusText}${body ? ` — ${body}` : ""}. Run \`vellum pair\` to try again.\n`,
+      );
       return;
     }
 
-    const hostId = createHash("sha256").update(hostname() + userInfo().username).digest("hex");
+    const hostId = createHash("sha256")
+      .update(hostname() + userInfo().username)
+      .digest("hex");
     const payload = JSON.stringify({
       type: "vellum-daemon",
       v: 4,
@@ -580,11 +646,15 @@ async function displayPairingQRCode(runtimeUrl: string, bearerToken: string | un
     mkdirSync(qrDir, { recursive: true });
     const qrPngPath = join(qrDir, "initial.png");
     try {
-      const pngBuffer = await QRCode.toBuffer(payload, { type: "png", width: 512 });
+      const pngBuffer = await QRCode.toBuffer(payload, {
+        type: "png",
+        width: 512,
+      });
       writeFileSync(qrPngPath, pngBuffer);
       console.log(`QR code PNG saved to ${qrPngPath}\n`);
     } catch (pngErr) {
-      const pngReason = pngErr instanceof Error ? pngErr.message : String(pngErr);
+      const pngReason =
+        pngErr instanceof Error ? pngErr.message : String(pngErr);
       console.warn(`\u26A0 Could not save QR code PNG: ${pngReason}\n`);
     }
 
@@ -595,18 +665,30 @@ async function displayPairingQRCode(runtimeUrl: string, bearerToken: string | un
   } catch (err) {
     // Non-fatal — pairing is optional
     const reason = err instanceof Error ? err.message : String(err);
-    console.warn(`⚠ Could not generate pairing QR code: ${reason}. Run \`vellum pair\` to try again.\n`);
+    console.warn(
+      `⚠ Could not generate pairing QR code: ${reason}. Run \`vellum pair\` to try again.\n`,
+    );
   }
 }
 
-async function hatchLocal(species: Species, name: string | null, daemonOnly: boolean = false, restart: boolean = false, watch: boolean = false): Promise<void> {
+async function hatchLocal(
+  species: Species,
+  name: string | null,
+  daemonOnly: boolean = false,
+  restart: boolean = false,
+  watch: boolean = false,
+): Promise<void> {
   if (restart && !name && !process.env.VELLUM_ASSISTANT_NAME) {
-    console.error("Error: Cannot restart without a known assistant ID. Provide --name or ensure VELLUM_ASSISTANT_NAME is set.");
+    console.error(
+      "Error: Cannot restart without a known assistant ID. Provide --name or ensure VELLUM_ASSISTANT_NAME is set.",
+    );
     process.exit(1);
   }
 
   const instanceName =
-    name ?? process.env.VELLUM_ASSISTANT_NAME ?? `${species}-${generateRandomSuffix()}`;
+    name ??
+    process.env.VELLUM_ASSISTANT_NAME ??
+    `${species}-${generateRandomSuffix()}`;
 
   // Clean up stale local state: if daemon/gateway processes are running but
   // the lock file has no entries, stop them before starting fresh.
@@ -617,7 +699,9 @@ async function hatchLocal(species: Species, name: string | null, daemonOnly: boo
     const daemonPid = isProcessAlive(join(vellumDir, "vellum.pid"));
     const gatewayPid = isProcessAlive(join(vellumDir, "gateway.pid"));
     if (daemonPid.alive || gatewayPid.alive) {
-      console.log("🧹 Cleaning up stale local processes (no lock file entry)...\n");
+      console.log(
+        "🧹 Cleaning up stale local processes (no lock file entry)...\n",
+      );
       await stopLocalProcesses();
     }
 
@@ -648,7 +732,11 @@ async function hatchLocal(species: Species, name: string | null, daemonOnly: boo
     }
   }
 
-  const baseDataDir = join(process.env.BASE_DATA_DIR?.trim() || (process.env.HOME ?? userInfo().homedir), ".vellum");
+  const baseDataDir = join(
+    process.env.BASE_DATA_DIR?.trim() ||
+      (process.env.HOME ?? userInfo().homedir),
+    ".vellum",
+  );
 
   console.log(`🥚 Hatching local assistant: ${instanceName}`);
   console.log(`   Species: ${species}`);
@@ -662,11 +750,15 @@ async function hatchLocal(species: Species, name: string | null, daemonOnly: boo
   } catch (error) {
     // Gateway failed — stop the daemon we just started so we don't leave
     // orphaned processes with no lock file entry.
-    console.error(`\n❌ Gateway startup failed — stopping daemon to avoid orphaned processes.`);
+    console.error(
+      `\n❌ Gateway startup failed — stopping assistant to avoid orphaned processes.`,
+    );
     await stopLocalProcesses();
     throw error;
   }
 
+  await startOutboundProxy(watch);
+
   // Read the bearer token written by the daemon so the client can authenticate
   // with the gateway (which requires auth by default).
   let bearerToken: string | undefined;
@@ -715,10 +807,13 @@ export async function hatch(): Promise<void> {
   const cliVersion = getCliVersion();
   console.log(`@vellumai/cli v${cliVersion}`);
 
-  const { species, detached, name, remote, daemonOnly, restart, watch } = parseArgs();
+  const { species, detached, name, remote, daemonOnly, restart, watch } =
+    parseArgs();
 
   if (restart && remote !== "local") {
-    console.error("Error: --restart is only supported for local hatch targets.");
+    console.error(
+      "Error: --restart is only supported for local hatch targets.",
+    );
     process.exit(1);
   }
 

package/src/commands/login.ts

@@ -48,7 +48,9 @@ export async function login(): Promise<void> {
     savePlatformToken(token);
     console.log(`✅ Logged in as ${user.email}`);
   } catch (error) {
-    console.error(`❌ Login failed: ${error instanceof Error ? error.message : error}`);
+    console.error(
+      `❌ Login failed: ${error instanceof Error ? error.message : error}`,
+    );
     process.exit(1);
   }
 }
@@ -58,7 +60,9 @@ export async function logout(): Promise<void> {
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: vellum logout");
     console.log("");
-    console.log("Log out of the Vellum platform and remove the stored session token.");
+    console.log(
+      "Log out of the Vellum platform and remove the stored session token.",
+    );
     process.exit(0);
   }
 

package/src/commands/pair.ts

@@ -55,16 +55,20 @@ async function pollForApproval(
 
     if (!statusRes.ok) {
       const body = await statusRes.text().catch(() => "");
-      throw new Error(`Failed to check pairing status: HTTP ${statusRes.status}: ${body || statusRes.statusText}`);
+      throw new Error(
+        `Failed to check pairing status: HTTP ${statusRes.status}: ${body || statusRes.statusText}`,
+      );
     }
 
-    const statusBody = await statusRes.json() as PairingResponse;
+    const statusBody = (await statusRes.json()) as PairingResponse;
 
     if (statusBody.status === "approved") {
       return statusBody;
     }
 
-    await new Promise((resolve) => setTimeout(resolve, PAIRING_POLL_INTERVAL_MS));
+    await new Promise((resolve) =>
+      setTimeout(resolve, PAIRING_POLL_INTERVAL_MS),
+    );
   }
 
   throw new Error("Pairing timed out waiting for approval.");
@@ -76,7 +80,9 @@ export async function pair(): Promise<void> {
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: vellum pair <path-to-qrcode.png>");
     console.log("");
-    console.log("Pair with a remote assistant by scanning the QR code PNG generated during setup.");
+    console.log(
+      "Pair with a remote assistant by scanning the QR code PNG generated during setup.",
+    );
     process.exit(0);
   }
 
@@ -85,7 +91,9 @@ export async function pair(): Promise<void> {
   if (!qrCodePath) {
     console.error("Usage: vellum pair <path-to-qrcode.png>");
     console.error("");
-    console.error("Pair with a remote assistant by scanning the QR code PNG generated during setup.");
+    console.error(
+      "Pair with a remote assistant by scanning the QR code PNG generated during setup.",
+    );
     process.exit(1);
   }
 
@@ -102,7 +110,12 @@ export async function pair(): Promise<void> {
       throw new Error("QR code does not contain valid pairing data.");
     }
 
-    if (payload.type !== "vellum-daemon" || !payload.g || !payload.pairingRequestId || !payload.pairingSecret) {
+    if (
+      payload.type !== "vellum-daemon" ||
+      !payload.g ||
+      !payload.pairingRequestId ||
+      !payload.pairingSecret
+    ) {
       throw new Error("QR code does not contain valid Vellum pairing data.");
     }
 
@@ -127,10 +140,12 @@ export async function pair(): Promise<void> {
 
     if (!requestRes.ok) {
       const body = await requestRes.text().catch(() => "");
-      throw new Error(`Failed to initiate pairing: HTTP ${requestRes.status}: ${body || requestRes.statusText}`);
+      throw new Error(
+        `Failed to initiate pairing: HTTP ${requestRes.status}: ${body || requestRes.statusText}`,
+      );
     }
 
-    const requestBody = await requestRes.json() as PairingResponse;
+    const requestBody = (await requestRes.json()) as PairingResponse;
 
     let bearerToken: string | undefined;
 
@@ -145,7 +160,9 @@ export async function pair(): Promise<void> {
       );
       bearerToken = approvedResponse.bearerToken;
     } else {
-      throw new Error(`Unexpected pairing response status: ${requestBody.status}`);
+      throw new Error(
+        `Unexpected pairing response status: ${requestBody.status}`,
+      );
     }
 
     const customEntry: AssistantEntry = {

package/src/commands/ps.ts

@@ -63,10 +63,14 @@ function printTable(rows: TableRow[]): void {
 // ── Remote process listing via SSH ──────────────────────────────
 
 const SSH_OPTS = [
-  "-o", "StrictHostKeyChecking=no",
-  "-o", "UserKnownHostsFile=/dev/null",
-  "-o", "ConnectTimeout=10",
-  "-o", "LogLevel=ERROR",
+  "-o",
+  "StrictHostKeyChecking=no",
+  "-o",
+  "UserKnownHostsFile=/dev/null",
+  "-o",
+  "ConnectTimeout=10",
+  "-o",
+  "LogLevel=ERROR",
 ];
 
 const REMOTE_PS_CMD = [
@@ -86,8 +90,8 @@ function classifyProcess(command: string): string {
   if (/qdrant/.test(command)) return "qdrant";
   if (/vellum-gateway/.test(command)) return "gateway";
   if (/openclaw/.test(command)) return "openclaw-adapter";
-  if (/vellum-daemon/.test(command)) return "daemon";
-  if (/daemon\s+(start|restart)/.test(command)) return "daemon";
+  if (/vellum-daemon/.test(command)) return "assistant";
+  if (/daemon\s+(start|restart)/.test(command)) return "assistant";
   // Exclude macOS desktop app processes — their path contains .app/Contents/MacOS/
   // but they are not background service processes.
   if (/\.app\/Contents\/MacOS\//.test(command)) return "unknown";
@@ -126,9 +130,7 @@ function resolveCloud(entry: AssistantEntry): string {
   return "local";
 }
 
-async function getRemoteProcessesGcp(
-  entry: AssistantEntry,
-): Promise<string> {
+async function getRemoteProcessesGcp(entry: AssistantEntry): Promise<string> {
   return execOutput("gcloud", [
     "compute",
     "ssh",
@@ -148,11 +150,7 @@ async function getRemoteProcessesCustom(
 ): Promise<string> {
   const host = extractHostFromUrl(entry.runtimeUrl);
   const sshUser = entry.sshUser ?? "root";
-  return execOutput("ssh", [
-    ...SSH_OPTS,
-    `${sshUser}@${host}`,
-    REMOTE_PS_CMD,
-  ]);
+  return execOutput("ssh", [...SSH_OPTS, `${sshUser}@${host}`, REMOTE_PS_CMD]);
 }
 
 interface ProcessSpec {
@@ -192,7 +190,7 @@ async function detectProcess(spec: ProcessSpec): Promise<DetectedProcess> {
   }
 
   // Tier 2: TCP port probe (skip for processes without a port)
-  const listening = spec.port > 0 && await probePort(spec.port);
+  const listening = spec.port > 0 && (await probePort(spec.port));
   if (listening) {
     const filePid = readPidFile(spec.pidFile);
     return {
@@ -222,11 +220,39 @@ function formatDetectionInfo(proc: DetectedProcess): string {
 async function getLocalProcesses(entry: AssistantEntry): Promise<TableRow[]> {
   const vellumDir = entry.baseDataDir ?? join(homedir(), ".vellum");
 
+  const PROXY_PORT = Number(process.env.PROXY_PORT) || 7829;
+
   const specs: ProcessSpec[] = [
-    { name: "daemon", pgrepName: "vellum-daemon", port: RUNTIME_HTTP_PORT, pidFile: join(vellumDir, "vellum.pid") },
-    { name: "qdrant", pgrepName: "qdrant", port: QDRANT_PORT, pidFile: join(vellumDir, "workspace", "data", "qdrant", "qdrant.pid") },
-    { name: "gateway", pgrepName: "vellum-gateway", port: GATEWAY_PORT, pidFile: join(vellumDir, "gateway.pid") },
-    { name: "embed-worker", pgrepName: "embed-worker", port: 0, pidFile: join(vellumDir, "embed-worker.pid") },
+    {
+      name: "assistant",
+      pgrepName: "vellum-daemon",
+      port: RUNTIME_HTTP_PORT,
+      pidFile: join(vellumDir, "vellum.pid"),
+    },
+    {
+      name: "qdrant",
+      pgrepName: "qdrant",
+      port: QDRANT_PORT,
+      pidFile: join(vellumDir, "workspace", "data", "qdrant", "qdrant.pid"),
+    },
+    {
+      name: "gateway",
+      pgrepName: "vellum-gateway",
+      port: GATEWAY_PORT,
+      pidFile: join(vellumDir, "gateway.pid"),
+    },
+    {
+      name: "outbound-proxy",
+      pgrepName: "outbound-proxy",
+      port: PROXY_PORT,
+      pidFile: join(vellumDir, "outbound-proxy.pid"),
+    },
+    {
+      name: "embed-worker",
+      pgrepName: "embed-worker",
+      port: 0,
+      pidFile: join(vellumDir, "embed-worker.pid"),
+    },
   ];
 
   const results = await Promise.all(specs.map(detectProcess));
@@ -260,7 +286,9 @@ async function showAssistantProcesses(entry: AssistantEntry): Promise<void> {
       process.exit(1);
     }
   } catch (error) {
-    console.error(`Failed to list processes: ${error instanceof Error ? error.message : error}`);
+    console.error(
+      `Failed to list processes: ${error instanceof Error ? error.message : error}`,
+    );
     process.exit(1);
   }
 
@@ -295,7 +323,7 @@ async function detectOrphanedProcesses(): Promise<OrphanedProcess[]> {
 
   // Strategy 1: PID file scan
   const pidFiles: Array<{ file: string; name: string }> = [
-    { file: join(vellumDir, "vellum.pid"), name: "daemon" },
+    { file: join(vellumDir, "vellum.pid"), name: "assistant" },
     { file: join(vellumDir, "gateway.pid"), name: "gateway" },
     { file: join(vellumDir, "qdrant.pid"), name: "qdrant" },
   ];
@@ -349,7 +377,9 @@ async function listAllAssistants(): Promise<void> {
       }));
       printTable(rows);
       const pids = orphans.map((o) => o.pid).join(" ");
-      console.log(`\nHint: Run \`kill ${pids}\` to clean up orphaned processes.`);
+      console.log(
+        `\nHint: Run \`kill ${pids}\` to clean up orphaned processes.`,
+      );
     }
 
     return;
@@ -413,7 +443,9 @@ export async function ps(): Promise<void> {
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: vellum ps [<name>]");
     console.log("");
-    console.log("List all assistants, or show processes for a specific assistant.");
+    console.log(
+      "List all assistants, or show processes for a specific assistant.",
+    );
     console.log("");
     console.log("Arguments:");
     console.log("  <name>    Show processes for the named assistant");

package/src/commands/recover.ts

@@ -13,7 +13,9 @@ export async function recover(): Promise<void> {
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: vellum recover <name>");
     console.log("");
-    console.log("Restore a previously retired local assistant from its archive.");
+    console.log(
+      "Restore a previously retired local assistant from its archive.",
+    );
     console.log("");
     console.log("Arguments:");
     console.log("  <name>    Name of the retired assistant to recover");
@@ -39,7 +41,7 @@ export async function recover(): Promise<void> {
   const vellumDir = join(homedir(), ".vellum");
   if (existsSync(vellumDir)) {
     console.error(
-      "Error: ~/.vellum already exists. Retire the current assistant first."
+      "Error: ~/.vellum already exists. Retire the current assistant first.",
     );
     process.exit(1);
   }