feat: headless delete via spawn delete --name <name> --yes (#3015)

Agents running on spawned VMs couldn't delete child spawns because
`spawn delete` requires an interactive terminal for the picker UI.

Added --name and --yes flags: when both are provided in non-interactive
mode, the server matching the name is deleted without prompts. This
enables agents to manage their own child VMs programmatically.

Updated all skill files to teach agents the headless delete syntax.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: A <258483684+la14-1@users.noreply.github.com>

Author: 3 people

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/spawn",
-  "version": "0.26.11",
+  "version": "0.26.12",
   "type": "module",
   "bin": {
     "spawn": "cli.js"

packages/cli/src/commands/delete.ts

@@ -352,7 +352,12 @@ export async function cascadeDelete(record: SpawnRecord, manifest: Manifest | nu
   return confirmAndDelete(record, manifest);
 }
 
-export async function cmdDelete(agentFilter?: string, cloudFilter?: string): Promise<void> {
+export async function cmdDelete(
+  agentFilter?: string,
+  cloudFilter?: string,
+  nameFilter?: string,
+  forceYes?: boolean,
+): Promise<void> {
   const resolved = await resolveListFilters(agentFilter, cloudFilter);
   agentFilter = resolved.agentFilter;
   cloudFilter = resolved.cloudFilter;
@@ -368,6 +373,15 @@ export async function cmdDelete(agentFilter?: string, cloudFilter?: string): Pro
     const lower = cloudFilter.toLowerCase();
     filtered = filtered.filter((r) => r.cloud.toLowerCase() === lower);
   }
+  if (nameFilter) {
+    const lower = nameFilter.toLowerCase();
+    filtered = filtered.filter(
+      (r) =>
+        (r.name ?? "").toLowerCase() === lower ||
+        (r.connection?.server_name ?? "").toLowerCase() === lower ||
+        r.id === nameFilter,
+    );
+  }
 
   if (filtered.length === 0) {
     p.log.info("No active servers to delete.");
@@ -387,10 +401,22 @@ export async function cmdDelete(agentFilter?: string, cloudFilter?: string): Pro
   const manifestResult = await asyncTryCatchIf(isNetworkError, loadManifest);
   const manifest: Manifest | null = manifestResult.ok ? manifestResult.data : null;
 
+  // Non-interactive headless delete: --name + --yes skips the picker
   if (!isInteractiveTTY()) {
-    p.log.error("spawn delete requires an interactive terminal.");
-    p.log.info(`Use ${pc.cyan("spawn list")} to see your servers.`);
-    process.exit(1);
+    if (!forceYes) {
+      p.log.error("spawn delete requires --yes in non-interactive mode.");
+      p.log.info(`Usage: ${pc.cyan("spawn delete --name <name> --yes")}`);
+      process.exit(1);
+    }
+    for (const record of filtered) {
+      const label = record.connection?.server_name || record.name || record.id;
+      await ensureDeleteCredentials(record);
+      const ok = await execDeleteServer(record);
+      if (ok) {
+        p.log.success(`Server "${label}" deleted`);
+      }
+    }
+    return;
   }
 
   await activeServerPicker(filtered, manifest);

packages/cli/src/index.ts

@@ -613,8 +613,16 @@ async function dispatchDeleteCommand(filteredArgs: string[]): Promise<void> {
     cmdHelp();
     return;
   }
-  const { agentFilter, cloudFilter } = parseListFilters(filteredArgs.slice(1));
-  await cmdDelete(agentFilter, cloudFilter);
+  const args = filteredArgs.slice(1);
+  const forceYes = args.includes("--yes") || args.includes("-y");
+  let nameFilter: string | undefined;
+  const nameIdx = args.indexOf("--name");
+  if (nameIdx !== -1 && args[nameIdx + 1]) {
+    nameFilter = args[nameIdx + 1];
+  }
+  const cleanArgs = args.filter((a) => a !== "--yes" && a !== "-y" && a !== "--name" && a !== nameFilter);
+  const { agentFilter, cloudFilter } = parseListFilters(cleanArgs);
+  await cmdDelete(agentFilter, cloudFilter, nameFilter, forceYes);
 }
 
 /** Handle status/ps commands with --prune and --json flags */

packages/cli/src/shared/spawn-skill.ts

@@ -44,7 +44,7 @@ Returns JSON: \`{"status":"success","ip_address":"...","ssh_user":"root","server
 ## Managing Children
 
 - \`spawn list --json\` — see running children
-- \`spawn delete\` — tear down a child VM
+- \`spawn delete --name <name> --yes\` — tear down a child VM (headless)
 - \`spawn tree\` — see the full spawn tree
 
 ## Context

skills/claude/SKILL.md

@@ -28,7 +28,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context

skills/codex/SKILL.md

@@ -28,7 +28,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context

skills/junie/AGENTS.md

@@ -22,7 +22,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context

skills/kilocode/spawn.md

@@ -22,7 +22,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context

skills/openclaw/SKILL.md

@@ -28,7 +28,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context

skills/opencode/AGENTS.md

@@ -22,7 +22,7 @@ Returns JSON: `{"status":"success","ip_address":"...","ssh_user":"root","server_
 ## Managing Children
 
 - `spawn list --json` — see running children
-- `spawn delete` — tear down a child VM
+- `spawn delete --name <name> --yes` — tear down a child VM
 - `spawn tree` — see the full spawn tree
 
 ## Context