volute 0.3.0 → 0.3.1

package/dist/{agent-manager-2LU6KULR.js → agent-manager-AUCKMGPR.js}

@@ -3,10 +3,10 @@ import {
   AgentManager,
   getAgentManager,
   initAgentManager
-} from "./chunk-IPIPLGME.js";
-import "./chunk-YEIHRP2J.js";
-import "./chunk-DEUAVGSA.js";
-import "./chunk-RALYNMHR.js";
+} from "./chunk-I6OHXCMV.js";
+import "./chunk-DNOXHLE5.js";
+import "./chunk-SOZA2TLP.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 export {
   AgentManager,

package/dist/{channel-H7N4SGR2.js → channel-7FZ6D25H.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   loadMergedEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   resolveAgentName
 } from "./chunk-VRVVQIYY.js";
@@ -10,7 +10,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/lib/channels/discord.ts

package/dist/{chunk-RALYNMHR.js → chunk-3C2XR4IY.js}

@@ -81,7 +81,7 @@ function removeAllVariants(agentName) {
 }
 async function checkHealth(port) {
   try {
-    const res = await fetch(`http://localhost:${port}/health`, {
+    const res = await fetch(`http://127.0.0.1:${port}/health`, {
       signal: AbortSignal.timeout(2e3)
     });
     if (!res.ok) return { ok: false };

package/dist/{chunk-YEIHRP2J.js → chunk-DNOXHLE5.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 
 // src/lib/env.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-IPIPLGME.js → chunk-I6OHXCMV.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   loadMergedEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   applyIsolation
-} from "./chunk-DEUAVGSA.js";
+} from "./chunk-SOZA2TLP.js";
 import {
   agentDir,
   findAgent,
@@ -13,7 +13,7 @@ import {
   setVariantRunning,
   validateBranchName,
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 
 // src/lib/agent-manager.ts
 import { execFile, spawn } from "child_process";
@@ -89,7 +89,7 @@ var AgentManager = class {
     const { dir, isVariant, baseName, variantName } = target;
     const port = target.port;
     try {
-      const res = await fetch(`http://localhost:${port}/health`);
+      const res = await fetch(`http://127.0.0.1:${port}/health`);
       if (res.ok) {
         console.error(`[daemon] killing orphan process on port ${port}`);
         await killProcessOnPort(port);

package/dist/{chunk-DEUAVGSA.js → chunk-SOZA2TLP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   validateAgentName
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 
 // src/lib/isolation.ts
 import { execFile, execFileSync } from "child_process";

package/dist/{chunk-VVD3XO3E.js → chunk-YGFIWIOF.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 
 // src/lib/daemon-client.ts
 import { existsSync, readFileSync } from "fs";

package/dist/cli.js

@@ -5,61 +5,61 @@ var command = process.argv[2];
 var args = process.argv.slice(3);
 switch (command) {
   case "create":
-    await import("./create-RSWWMGKT.js").then((m) => m.run(args));
+    await import("./create-BRG2DBWI.js").then((m) => m.run(args));
     break;
   case "start":
-    await import("./start-2BSXX6BS.js").then((m) => m.run(args));
+    await import("./start-LDPMCMYT.js").then((m) => m.run(args));
     break;
   case "stop":
-    await import("./stop-DSKBIJ2D.js").then((m) => m.run(args));
+    await import("./stop-5PZTZCLL.js").then((m) => m.run(args));
     break;
   case "logs":
-    await import("./logs-NHWGHNBF.js").then((m) => m.run(args));
+    await import("./logs-NXFFGUKY.js").then((m) => m.run(args));
     break;
   case "status":
-    await import("./status-N23CV27T.js").then((m) => m.run(args));
+    await import("./status-MVSQG54T.js").then((m) => m.run(args));
     break;
   case "variant":
-    await import("./variant-JPLJTS2P.js").then((m) => m.run(args));
+    await import("./variant-CVYM3EQG.js").then((m) => m.run(args));
     break;
   case "send":
-    await import("./send-5LEJXPYV.js").then((m) => m.run(args));
+    await import("./send-UK3JBZIB.js").then((m) => m.run(args));
     break;
   case "import":
-    await import("./import-6HTSSDFW.js").then((m) => m.run(args));
+    await import("./import-K4MP2GX7.js").then((m) => m.run(args));
     break;
   case "delete":
-    await import("./delete-4ERL2QHH.js").then((m) => m.run(args));
+    await import("./delete-GQ7JEK2S.js").then((m) => m.run(args));
     break;
   case "env":
-    await import("./env-DBWDTIP6.js").then((m) => m.run(args));
+    await import("./env-JB27UAC3.js").then((m) => m.run(args));
     break;
   case "connector":
-    await import("./connector-6LWB5PRU.js").then((m) => m.run(args));
+    await import("./connector-TVJULIRT.js").then((m) => m.run(args));
     break;
   case "channel":
-    await import("./channel-H7N4SGR2.js").then((m) => m.run(args));
+    await import("./channel-7FZ6D25H.js").then((m) => m.run(args));
     break;
   case "upgrade":
-    await import("./upgrade-BGFVRCVP.js").then((m) => m.run(args));
+    await import("./upgrade-CDKECCGN.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-4UGID4DM.js").then((m) => m.run(args));
+    await import("./up-UT3IMKCA.js").then((m) => m.run(args));
     break;
   case "down":
-    await import("./down-HRC4MQCT.js").then((m) => m.run(args));
+    await import("./down-3OB6UVAJ.js").then((m) => m.run(args));
     break;
   case "schedule":
-    await import("./schedule-DKZ2E2CL.js").then((m) => m.run(args));
+    await import("./schedule-4I5TYHFH.js").then((m) => m.run(args));
     break;
   case "history":
-    await import("./history-W7BD2H74.js").then((m) => m.run(args));
+    await import("./history-3VRUBGGV.js").then((m) => m.run(args));
     break;
   case "service":
     await import("./service-SA4TTMDU.js").then((m) => m.run(args));
     break;
   case "setup":
-    await import("./setup-ZMNTOJAV.js").then((m) => m.run(args));
+    await import("./setup-SRS7AUAA.js").then((m) => m.run(args));
     break;
   default:
     console.log(`volute \u2014 create and manage AI agents
@@ -74,6 +74,7 @@ Commands:
   volute variant create <name>          Create a variant (worktree + server)
   volute variant list                   List variants for an agent
   volute variant merge <name>           Merge a variant back
+  volute variant delete <name>          Delete a variant
   volute import <path>                  Import an OpenClaw workspace
   volute env <set|get|list|remove>      Manage environment variables
   volute connector connect <type>       Enable a connector for an agent

package/dist/{connector-6LWB5PRU.js → connector-TVJULIRT.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   loadMergedEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgentName
 } from "./chunk-VRVVQIYY.js";
@@ -13,7 +13,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/connector.ts

package/dist/connectors/discord.js

@@ -24,7 +24,7 @@ if (!token) {
 var guildId = process.env.DISCORD_GUILD_ID;
 var daemonUrl = process.env.VOLUTE_DAEMON_URL;
 var daemonToken = process.env.VOLUTE_DAEMON_TOKEN;
-var baseUrl = daemonUrl ? `${daemonUrl}/api/agents/${encodeURIComponent(agentName)}` : `http://localhost:${agentPort}`;
+var baseUrl = daemonUrl ? `${daemonUrl}/api/agents/${encodeURIComponent(agentName)}` : `http://127.0.0.1:${agentPort}`;
 var client = new Client({
   intents: [
     GatewayIntentBits.Guilds,
@@ -42,7 +42,7 @@ process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
 client.once(Events.ClientReady, (c) => {
   console.log(`Connected to Discord as ${c.user.tag}`);
-  console.log(`Bridging to agent: ${agentName} (port ${agentPort})`);
+  console.log(`Bridging to agent: ${agentName} via ${baseUrl}/message`);
 });
 client.on(Events.MessageCreate, async (message) => {
   if (message.author.bot) return;
@@ -207,6 +207,8 @@ async function handleAgentRequest(message, content) {
       })
     });
     if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      console.error(`Agent returned ${res.status}: ${body}`);
       await message.reply(`Error: agent returned ${res.status}`);
       clearInterval(typingInterval);
       return;
@@ -232,6 +234,7 @@ async function handleAgentRequest(message, content) {
     }
     await flush();
   } catch (err) {
+    console.error(`Failed to reach agent at ${baseUrl}/message:`, err);
     const errMsg = err instanceof TypeError && err.cause?.code === "ECONNREFUSED" ? "Agent is not running" : `Error: ${err}`;
     await message.reply(errMsg).catch(() => {
     });

package/dist/{create-RSWWMGKT.js → create-BRG2DBWI.js}

@@ -13,7 +13,7 @@ import {
   chownAgentDir,
   createAgentUser,
   ensureVoluteGroup
-} from "./chunk-DEUAVGSA.js";
+} from "./chunk-SOZA2TLP.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -22,7 +22,7 @@ import {
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/create.ts

package/dist/{daemon-client-27KMQQKX.js → daemon-client-XR24PUJF.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
-import "./chunk-RALYNMHR.js";
+} from "./chunk-YGFIWIOF.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 export {
   daemonFetch

package/dist/daemon.js

@@ -5,7 +5,7 @@ import {
   initAgentManager,
   loadJsonMap,
   saveJsonMap
-} from "./chunk-IPIPLGME.js";
+} from "./chunk-I6OHXCMV.js";
 import {
   logBuffer,
   logger_default,
@@ -17,10 +17,10 @@ import {
 } from "./chunk-NETNFBA5.js";
 import {
   loadMergedEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   applyIsolation
-} from "./chunk-DEUAVGSA.js";
+} from "./chunk-SOZA2TLP.js";
 import {
   agentDir,
   checkHealth,
@@ -34,7 +34,7 @@ import {
   setAgentRunning,
   setVariantRunning,
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import {
   __export
 } from "./chunk-K3NQKI34.js";
@@ -138,7 +138,7 @@ var ConnectorManager = class {
         VOLUTE_AGENT_PORT: String(agentPort),
         VOLUTE_AGENT_NAME: agentName,
         ...daemonPort ? {
-          VOLUTE_DAEMON_URL: `http://localhost:${daemonPort}`,
+          VOLUTE_DAEMON_URL: `http://127.0.0.1:${daemonPort}`,
           VOLUTE_DAEMON_TOKEN: process.env.VOLUTE_DAEMON_TOKEN
         } : {},
         ...connectorEnv
@@ -377,7 +377,7 @@ var Scheduler = class {
     try {
       let res;
       if (this.daemonPort && this.daemonToken) {
-        const daemonUrl = `http://localhost:${this.daemonPort}`;
+        const daemonUrl = `http://127.0.0.1:${this.daemonPort}`;
         res = await fetch(`${daemonUrl}/api/agents/${encodeURIComponent(agentName)}/message`, {
           method: "POST",
           headers: {
@@ -388,7 +388,7 @@ var Scheduler = class {
           body
         });
       } else {
-        res = await fetch(`http://localhost:${entry.port}/message`, {
+        res = await fetch(`http://127.0.0.1:${entry.port}/message`, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body
@@ -866,7 +866,7 @@ var app = new Hono().get("/", async (c) => {
       console.error(`[daemon] failed to persist inbound message for ${baseName}:`, err);
     }
   }
-  const res = await fetch(`http://localhost:${port}/message`, {
+  const res = await fetch(`http://127.0.0.1:${port}/message`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body
@@ -1116,7 +1116,7 @@ var app3 = new Hono3().post("/:name/chat", zValidator2("json", chatSchema), asyn
     if (!variant) return c.json({ error: `Unknown variant: ${variantName}` }, 404);
     port = variant.port;
   }
-  const { getAgentManager: getAgentManager2 } = await import("./agent-manager-2LU6KULR.js");
+  const { getAgentManager: getAgentManager2 } = await import("./agent-manager-AUCKMGPR.js");
   if (!getAgentManager2().isRunning(name)) {
     return c.json({ error: "Agent is not running" }, 409);
   }
@@ -1155,7 +1155,7 @@ var app3 = new Hono3().post("/:name/chat", zValidator2("json", chatSchema), asyn
     sender: user.username,
     content: body.message ?? "[image]"
   });
-  const res = await fetch(`http://localhost:${port}/message`, {
+  const res = await fetch(`http://127.0.0.1:${port}/message`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
@@ -1451,7 +1451,7 @@ var app8 = new Hono8().get("/:name/schedules", (c) => {
   const body = await c.req.text();
   const message = `[webhook: ${event}] ${body}`;
   try {
-    const res = await fetch(`http://localhost:${entry.port}/message`, {
+    const res = await fetch(`http://127.0.0.1:${entry.port}/message`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({

package/dist/{delete-4ERL2QHH.js → delete-GQ7JEK2S.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   deleteAgentUser
-} from "./chunk-DEUAVGSA.js";
+} from "./chunk-SOZA2TLP.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -10,7 +10,7 @@ import {
   findAgent,
   removeAgent,
   removeAllVariants
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/delete.ts
@@ -30,7 +30,7 @@ async function run(args) {
     process.exit(1);
   }
   try {
-    const { daemonFetch } = await import("./daemon-client-27KMQQKX.js");
+    const { daemonFetch } = await import("./daemon-client-XR24PUJF.js");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
       method: "POST"
     });

package/dist/{down-HRC4MQCT.js → down-3OB6UVAJ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/down.ts

package/dist/{env-DBWDTIP6.js → env-JB27UAC3.js}

@@ -5,13 +5,13 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/env.ts

package/dist/{history-W7BD2H74.js → history-3VRUBGGV.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgentName
 } from "./chunk-VRVVQIYY.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-RALYNMHR.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/history.ts

package/dist/{import-6HTSSDFW.js → import-K4MP2GX7.js}

@@ -7,7 +7,7 @@ import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-YEIHRP2J.js";
+} from "./chunk-DNOXHLE5.js";
 import {
   composeTemplate,
   copyTemplateToDir,
@@ -25,7 +25,7 @@ import {
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/import.ts

package/dist/{logs-NHWGHNBF.js → logs-NXFFGUKY.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/logs.ts

package/dist/{schedule-DKZ2E2CL.js → schedule-4I5TYHFH.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgentName
 } from "./chunk-VRVVQIYY.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-RALYNMHR.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/schedule.ts

package/dist/{send-5LEJXPYV.js → send-UK3JBZIB.js}

@@ -4,8 +4,8 @@ import {
 } from "./chunk-N4YNKR3Q.js";
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
-import "./chunk-RALYNMHR.js";
+} from "./chunk-YGFIWIOF.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/send.ts

package/dist/{setup-ZMNTOJAV.js → setup-SRS7AUAA.js}

@@ -4,11 +4,11 @@ import {
 } from "./chunk-5SKQ6J7T.js";
 import {
   ensureVoluteGroup
-} from "./chunk-DEUAVGSA.js";
+} from "./chunk-SOZA2TLP.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-RALYNMHR.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts

package/dist/{start-2BSXX6BS.js → start-LDPMCMYT.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/start.ts

package/dist/{status-N23CV27T.js → status-MVSQG54T.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
-import "./chunk-RALYNMHR.js";
+} from "./chunk-YGFIWIOF.js";
+import "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/status.ts

package/dist/{stop-DSKBIJ2D.js → stop-5PZTZCLL.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/stop.ts

package/dist/{up-4UGID4DM.js → up-UT3IMKCA.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   voluteHome
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/up.ts

package/dist/{upgrade-BGFVRCVP.js → upgrade-CDKECCGN.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  spawnServer
-} from "./chunk-MY74SUOL.js";
 import {
   composeTemplate,
   copyTemplateToDir,
@@ -11,13 +8,17 @@ import {
   exec,
   execInherit
 } from "./chunk-5SKQ6J7T.js";
+import {
+  daemonFetch
+} from "./chunk-YGFIWIOF.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   addVariant,
+  nextPort,
   resolveAgent
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/upgrade.ts
@@ -41,12 +42,12 @@ async function run(args) {
     await continueUpgrade(agentName, projectRoot);
     return;
   }
-  const worktreeDir = resolve(projectRoot, ".worktrees", VARIANT_NAME);
+  const worktreeDir = resolve(projectRoot, ".variants", VARIANT_NAME);
   if (existsSync(worktreeDir)) {
     console.error(
-      `Upgrade worktree already exists: ${worktreeDir}
+      `Upgrade variant already exists: ${worktreeDir}
 If a previous upgrade is in progress, use --continue to finish it.
-Otherwise, remove it with: git -C ${projectRoot} worktree remove .worktrees/${VARIANT_NAME}`
+Otherwise, remove it with: volute variant delete ${VARIANT_NAME} --agent ${agentName}`
     );
     process.exit(1);
   }
@@ -58,7 +59,7 @@ Otherwise, remove it with: git -C ${projectRoot} worktree remove .worktrees/${VA
   console.log("Updating template branch...");
   await updateTemplateBranch(projectRoot, template, agentName);
   console.log("Creating upgrade variant...");
-  const parentDir = resolve(projectRoot, ".worktrees");
+  const parentDir = resolve(projectRoot, ".variants");
   if (!existsSync(parentDir)) {
     mkdirSync(parentDir, { recursive: true });
   }
@@ -78,7 +79,7 @@ Then run:`);
   await installAndVerify(agentName, worktreeDir);
 }
 async function updateTemplateBranch(projectRoot, template, agentName) {
-  const tempWorktree = resolve(projectRoot, ".worktrees", "_template_update");
+  const tempWorktree = resolve(projectRoot, ".variants", "_template_update");
   let branchExists = false;
   try {
     await exec("git", ["rev-parse", "--verify", TEMPLATE_BRANCH], {
@@ -161,7 +162,7 @@ async function mergeTemplateBranch(worktreeDir) {
   }
 }
 async function continueUpgrade(agentName, projectRoot) {
-  const worktreeDir = resolve(projectRoot, ".worktrees", VARIANT_NAME);
+  const worktreeDir = resolve(projectRoot, ".variants", VARIANT_NAME);
   if (!existsSync(worktreeDir)) {
     console.error("No upgrade in progress. Run `volute upgrade` first.");
     process.exit(1);
@@ -184,22 +185,34 @@ async function continueUpgrade(agentName, projectRoot) {
 async function installAndVerify(agentName, worktreeDir) {
   console.log("Installing dependencies...");
   await execInherit("npm", ["install"], { cwd: worktreeDir });
-  console.log("Starting upgrade variant...");
-  const result = await spawnServer(worktreeDir, 0, { detached: true });
-  if (!result) {
-    console.error("Server failed to start within timeout");
-    process.exit(1);
-  }
-  const { actualPort } = result;
+  const variantPort = nextPort();
   addVariant(agentName, {
     name: VARIANT_NAME,
     branch: VARIANT_NAME,
     path: worktreeDir,
-    port: actualPort,
+    port: variantPort,
     created: (/* @__PURE__ */ new Date()).toISOString()
   });
+  console.log("Starting upgrade variant...");
+  try {
+    const res = await daemonFetch(
+      `/api/agents/${encodeURIComponent(`${agentName}@${VARIANT_NAME}`)}/start`,
+      { method: "POST" }
+    );
+    if (!res.ok) {
+      const data = await res.json();
+      console.error(data.error ?? "Failed to start variant");
+      process.exit(1);
+    }
+  } catch {
+    console.error("Failed to start variant. Is the daemon running? (volute up)");
+    console.error(
+      `The variant was created but not started. Use: volute start ${agentName}@${VARIANT_NAME}`
+    );
+    process.exit(1);
+  }
   console.log(`
-Upgrade variant running on port ${actualPort}`);
+Upgrade variant running on port ${variantPort}`);
   console.log(`
 Next steps:`);
   console.log(`  volute send ${agentName}@${VARIANT_NAME} "hello"    # chat with upgraded variant`);

package/dist/{variant-JPLJTS2P.js → variant-CVYM3EQG.js}

@@ -1,14 +1,11 @@
 #!/usr/bin/env node
-import {
-  spawnServer
-} from "./chunk-MY74SUOL.js";
 import {
   exec,
   execInherit
 } from "./chunk-5SKQ6J7T.js";
 import {
   daemonFetch
-} from "./chunk-VVD3XO3E.js";
+} from "./chunk-YGFIWIOF.js";
 import {
   resolveAgentName
 } from "./chunk-VRVVQIYY.js";
@@ -25,12 +22,88 @@ import {
   resolveAgent,
   validateBranchName,
   writeVariants
-} from "./chunk-RALYNMHR.js";
+} from "./chunk-3C2XR4IY.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/variant.ts
-import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync as mkdirSync2, writeFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/lib/spawn-server.ts
+import { spawn } from "child_process";
+import { closeSync, mkdirSync, openSync, readFileSync } from "fs";
 import { resolve } from "path";
+function tsxBin(cwd) {
+  return resolve(cwd, "node_modules", ".bin", "tsx");
+}
+function spawnServer(cwd, port, options) {
+  if (options?.detached) {
+    return spawnDetached(cwd, port);
+  }
+  return spawnAttached(cwd, port);
+}
+function spawnAttached(cwd, port) {
+  const child = spawn(tsxBin(cwd), ["src/server.ts", "--port", String(port)], {
+    cwd,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  return new Promise((resolve3) => {
+    const timeout = setTimeout(() => resolve3(null), 3e4);
+    function checkOutput(data) {
+      const match = data.toString().match(/listening on :(\d+)/);
+      if (match) {
+        clearTimeout(timeout);
+        resolve3({ child, actualPort: parseInt(match[1], 10) });
+      }
+    }
+    child.stdout?.on("data", checkOutput);
+    child.stderr?.on("data", checkOutput);
+    child.on("error", () => {
+      clearTimeout(timeout);
+      resolve3(null);
+    });
+    child.on("exit", () => {
+      clearTimeout(timeout);
+      resolve3(null);
+    });
+  });
+}
+function spawnDetached(cwd, port) {
+  const logsDir = resolve(cwd, ".volute", "logs");
+  mkdirSync(logsDir, { recursive: true });
+  const logPath = resolve(logsDir, "agent.log");
+  const logFd = openSync(logPath, "a");
+  const child = spawn(tsxBin(cwd), ["src/server.ts", "--port", String(port)], {
+    cwd,
+    stdio: ["ignore", logFd, logFd],
+    detached: true
+  });
+  child.unref();
+  closeSync(logFd);
+  return new Promise((res) => {
+    let done = false;
+    function finish(result) {
+      if (done) return;
+      done = true;
+      clearInterval(interval);
+      clearTimeout(timeout);
+      res(result);
+    }
+    const interval = setInterval(() => {
+      try {
+        const content = readFileSync(logPath, "utf-8");
+        const match = content.match(/listening on :(\d+)/);
+        if (match) {
+          finish({ child, actualPort: parseInt(match[1], 10) });
+        }
+      } catch {
+      }
+    }, 100);
+    const timeout = setTimeout(() => finish(null), 3e4);
+    child.on("error", () => finish(null));
+    child.on("exit", () => finish(null));
+  });
+}
 
 // src/lib/verify.ts
 async function verify(port) {
@@ -41,7 +114,7 @@ async function verify(port) {
   }
   console.log("  Health check: OK");
   try {
-    const res = await fetch(`http://localhost:${port}/message`, {
+    const res = await fetch(`http://127.0.0.1:${port}/message`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -106,6 +179,9 @@ async function run(args) {
     case "merge":
       await mergeVariant(args.slice(1));
       break;
+    case "delete":
+      await deleteVariant(args.slice(1));
+      break;
     default:
       printUsage();
       process.exit(subcommand ? 1 : 0);
@@ -115,7 +191,8 @@ function printUsage() {
   console.error(`Usage:
   volute variant create <variant> [--agent <name>] [--soul "..."] [--port N] [--no-start] [--json]
   volute variant list [--agent <name>] [--json]
-  volute variant merge <variant> [--agent <name>] [--summary "..." --memory "..."] [--skip-verify]`);
+  volute variant merge <variant> [--agent <name>] [--summary "..." --memory "..."] [--skip-verify]
+  volute variant delete <variant> [--agent <name>]`);
 }
 async function createVariant(args) {
   const { positional, flags } = parseArgs(args, {
@@ -141,12 +218,12 @@ async function createVariant(args) {
     process.exit(1);
   }
   const { dir: projectRoot } = resolveAgent(agentName);
-  const variantDir = resolve(projectRoot, ".variants", variantName);
+  const variantDir = resolve2(projectRoot, ".variants", variantName);
   if (existsSync(variantDir)) {
     console.error(`Variant directory already exists: ${variantDir}`);
     process.exit(1);
   }
-  mkdirSync(resolve(projectRoot, ".variants"), { recursive: true });
+  mkdirSync2(resolve2(projectRoot, ".variants"), { recursive: true });
   try {
     await exec("git", ["worktree", "add", "-b", variantName, variantDir], { cwd: projectRoot });
   } catch (e) {
@@ -167,7 +244,7 @@ async function createVariant(args) {
     process.exit(1);
   }
   if (soul) {
-    writeFileSync(resolve(variantDir, "home/SOUL.md"), soul);
+    writeFileSync(resolve2(variantDir, "home/SOUL.md"), soul);
   }
   const variantPort = port ?? nextPort();
   const variant = {
@@ -353,10 +430,10 @@ async function mergeVariant(args) {
     console.error("npm install failed:", e);
   }
   console.log(`Variant ${variantName} merged and cleaned up.`);
-  const voluteDir = resolve(projectRoot, ".volute");
-  if (!existsSync(voluteDir)) mkdirSync(voluteDir, { recursive: true });
+  const voluteDir = resolve2(projectRoot, ".volute");
+  if (!existsSync(voluteDir)) mkdirSync2(voluteDir, { recursive: true });
   writeFileSync(
-    resolve(voluteDir, "merged.json"),
+    resolve2(voluteDir, "merged.json"),
     JSON.stringify({
       name: variantName,
       ...flags.summary && { summary: flags.summary },
@@ -380,6 +457,41 @@ async function mergeVariant(args) {
     console.log(`Daemon not running. Start the agent manually: volute start ${agentName}`);
   }
 }
+async function deleteVariant(args) {
+  const { positional, flags } = parseArgs(args, {
+    agent: { type: "string" }
+  });
+  const agentName = resolveAgentName(flags);
+  const variantName = positional[0];
+  if (!variantName) {
+    console.error("Usage: volute variant delete <variant> [--agent <name>]");
+    process.exit(1);
+  }
+  const { dir: projectRoot } = resolveAgent(agentName);
+  const variant = findVariant(agentName, variantName);
+  if (!variant) {
+    console.error(`Unknown variant: ${variantName}`);
+    process.exit(1);
+  }
+  try {
+    await daemonFetch(`/api/agents/${encodeURIComponent(`${agentName}@${variantName}`)}/stop`, {
+      method: "POST"
+    });
+  } catch {
+  }
+  if (existsSync(variant.path)) {
+    try {
+      await exec("git", ["worktree", "remove", "--force", variant.path], { cwd: projectRoot });
+    } catch {
+    }
+  }
+  try {
+    await exec("git", ["branch", "-D", variant.branch], { cwd: projectRoot });
+  } catch {
+  }
+  removeVariant(agentName, variantName);
+  console.log(`Variant ${variantName} deleted.`);
+}
 export {
   run
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",

package/templates/_base/_skills/volute-agent/SKILL.md

@@ -18,6 +18,7 @@ You manage yourself through the `volute` CLI. Commands that operate on "your" ag
 | `volute variant create <name> [--soul "..."] [--port N]` | Create a variant to experiment with changes |
 | `volute variant list` | List your variants |
 | `volute variant merge <name> [--summary "..." --memory "..."]` | Merge a variant back |
+| `volute variant delete <name>` | Delete a variant without merging |
 | `volute upgrade [--template <name>] [--continue]` | Upgrade your server code |
 | `volute connector connect <type>` | Enable a connector (e.g. discord) |
 | `volute connector disconnect <type>` | Disable a connector |
@@ -57,7 +58,7 @@ Edit `.config/hooks/startup-context.sh` to customize what you see when a new ses
 Variants let you experiment safely — fork yourself, try changes, and merge back what works. Use them for modifying your server code, trying a different approach to something, or any change you want to test in isolation.
 
 1. `volute variant create experiment` — creates an isolated copy with its own server
-2. Make changes in the variant's worktree (at `../.worktrees/experiment/`)
+2. Make changes in the variant's worktree (at `../.variants/experiment/`)
 3. Test: `volute send $VOLUTE_AGENT@experiment "hello"`
 4. `volute variant merge experiment --summary "..." --memory "..."` — merges back after verification
 

package/dist/chunk-MY74SUOL.js

@@ -1,81 +0,0 @@
-#!/usr/bin/env node
-
-// src/lib/spawn-server.ts
-import { spawn } from "child_process";
-import { closeSync, mkdirSync, openSync, readFileSync } from "fs";
-import { resolve } from "path";
-function tsxBin(cwd) {
-  return resolve(cwd, "node_modules", ".bin", "tsx");
-}
-function spawnServer(cwd, port, options) {
-  if (options?.detached) {
-    return spawnDetached(cwd, port);
-  }
-  return spawnAttached(cwd, port);
-}
-function spawnAttached(cwd, port) {
-  const child = spawn(tsxBin(cwd), ["src/server.ts", "--port", String(port)], {
-    cwd,
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  return new Promise((resolve2) => {
-    const timeout = setTimeout(() => resolve2(null), 3e4);
-    function checkOutput(data) {
-      const match = data.toString().match(/listening on :(\d+)/);
-      if (match) {
-        clearTimeout(timeout);
-        resolve2({ child, actualPort: parseInt(match[1], 10) });
-      }
-    }
-    child.stdout?.on("data", checkOutput);
-    child.stderr?.on("data", checkOutput);
-    child.on("error", () => {
-      clearTimeout(timeout);
-      resolve2(null);
-    });
-    child.on("exit", () => {
-      clearTimeout(timeout);
-      resolve2(null);
-    });
-  });
-}
-function spawnDetached(cwd, port) {
-  const logsDir = resolve(cwd, ".volute", "logs");
-  mkdirSync(logsDir, { recursive: true });
-  const logPath = resolve(logsDir, "agent.log");
-  const logFd = openSync(logPath, "a");
-  const child = spawn(tsxBin(cwd), ["src/server.ts", "--port", String(port)], {
-    cwd,
-    stdio: ["ignore", logFd, logFd],
-    detached: true
-  });
-  child.unref();
-  closeSync(logFd);
-  return new Promise((res) => {
-    let done = false;
-    function finish(result) {
-      if (done) return;
-      done = true;
-      clearInterval(interval);
-      clearTimeout(timeout);
-      res(result);
-    }
-    const interval = setInterval(() => {
-      try {
-        const content = readFileSync(logPath, "utf-8");
-        const match = content.match(/listening on :(\d+)/);
-        if (match) {
-          finish({ child, actualPort: parseInt(match[1], 10) });
-        }
-      } catch {
-      }
-    }, 100);
-    const timeout = setTimeout(() => finish(null), 3e4);
-    child.on("error", () => finish(null));
-    child.on("exit", () => finish(null));
-  });
-}
-
-export {
-  spawnServer
-};