volute 0.10.1 → 0.11.0

package/README.md

@@ -36,6 +36,7 @@ One background process runs everything. `volute up` starts it; `volute down` sto
 volute up              # start (default port 4200)
 volute up --port 8080  # custom port
 volute down            # stop all agents and shut down
+volute status          # check daemon status, version, and agents
 ```
 
 The daemon handles agent lifecycle, crash recovery (auto-restarts after 3 seconds), connector processes, scheduled messages, and the web dashboard.
@@ -232,7 +233,7 @@ The container runs with per-agent user isolation enabled — each agent gets its
 
 ### Bare metal (Linux / Raspberry Pi)
 
-One-liner install on a fresh Debian/Ubuntu system:
+One-liner install on a fresh Linux system (Debian/Ubuntu, RHEL/Fedora, Arch, Alpine, SUSE):
 
 ```sh
 curl -fsSL <install-url> | sudo bash

package/dist/{agent-ECRX44DB.js → agent-JGO6N7IA.js}

@@ -21,14 +21,14 @@ async function run(args) {
       await import("./delete-BOTVU4YO.js").then((m) => m.run(args.slice(1)));
       break;
     case "list":
-      await import("./status-SIMKH3ZE.js").then((m) => m.run(args.slice(1)));
+      await import("./status-CTWXP6UW.js").then((m) => m.run(args.slice(1)));
       break;
     case "status": {
       const rest = args.slice(1);
       if (!rest[0] && process.env.VOLUTE_AGENT) {
         rest.unshift(process.env.VOLUTE_AGENT);
       }
-      await import("./status-SIMKH3ZE.js").then((m) => m.run(rest));
+      await import("./status-CTWXP6UW.js").then((m) => m.run(rest));
       break;
     }
     case "logs": {

package/dist/chunk-25GGN3OV.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import {
+  execInherit
+} from "./chunk-5C5JWR2L.js";
+import {
+  voluteHome
+} from "./chunk-DP2DX4WV.js";
+
+// src/lib/service-mode.ts
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { resolve } from "path";
+var SYSTEM_SERVICE_PATH = "/etc/systemd/system/volute.service";
+var USER_SYSTEMD_UNIT = resolve(homedir(), ".config", "systemd", "user", "volute.service");
+var LAUNCHD_PLIST_LABEL = "com.volute.daemon";
+var LAUNCHD_PLIST_PATH = resolve(
+  homedir(),
+  "Library",
+  "LaunchAgents",
+  `${LAUNCHD_PLIST_LABEL}.plist`
+);
+var HEALTH_POLL_TIMEOUT = 3e4;
+var STOP_GRACE_TIMEOUT = 1e4;
+var POLL_INTERVAL = 500;
+function getServiceMode() {
+  if (existsSync(SYSTEM_SERVICE_PATH)) {
+    try {
+      execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
+      return "system";
+    } catch {
+    }
+  }
+  if (existsSync(USER_SYSTEMD_UNIT)) {
+    try {
+      execFileSync("systemctl", ["--user", "is-enabled", "--quiet", "volute"]);
+      return "user-systemd";
+    } catch {
+    }
+  }
+  if (process.platform === "darwin" && existsSync(LAUNCHD_PLIST_PATH)) {
+    return "user-launchd";
+  }
+  return "manual";
+}
+function getDaemonUrl(hostname, port) {
+  const url = new URL("http://localhost");
+  let h = hostname;
+  if (h === "0.0.0.0" || h === "::") h = "localhost";
+  else if (h.includes(":") && !h.startsWith("[")) h = `[${h}]`;
+  url.hostname = h;
+  url.port = String(port);
+  return url.origin;
+}
+async function pollHealth(hostname, port, timeout = HEALTH_POLL_TIMEOUT) {
+  const url = `${getDaemonUrl(hostname, port)}/api/health`;
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    try {
+      const res = await fetch(url);
+      if (res.ok) {
+        const body = await res.json().catch(() => null);
+        if (body && body.ok) return true;
+      }
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, POLL_INTERVAL));
+  }
+  return false;
+}
+async function pollHealthDown(hostname, port, timeout = STOP_GRACE_TIMEOUT) {
+  const url = `${getDaemonUrl(hostname, port)}/api/health`;
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    try {
+      const res = await fetch(url);
+      if (!res.ok) return true;
+      const body = await res.json().catch(() => null);
+      if (!body || !body.ok) return true;
+    } catch {
+      return true;
+    }
+    await new Promise((r) => setTimeout(r, POLL_INTERVAL));
+  }
+  return false;
+}
+async function startService(mode) {
+  switch (mode) {
+    case "system":
+      await execInherit("sudo", ["systemctl", "start", "volute"]);
+      break;
+    case "user-systemd":
+      await execInherit("systemctl", ["--user", "start", "volute"]);
+      break;
+    case "user-launchd":
+      await execInherit("launchctl", ["load", LAUNCHD_PLIST_PATH]);
+      break;
+  }
+}
+async function stopService(mode) {
+  switch (mode) {
+    case "system":
+      await execInherit("sudo", ["systemctl", "stop", "volute"]);
+      break;
+    case "user-systemd":
+      await execInherit("systemctl", ["--user", "stop", "volute"]);
+      break;
+    case "user-launchd":
+      await execInherit("launchctl", ["unload", LAUNCHD_PLIST_PATH]);
+      break;
+  }
+}
+async function restartService(mode) {
+  switch (mode) {
+    case "system":
+      await execInherit("sudo", ["systemctl", "restart", "volute"]);
+      break;
+    case "user-systemd":
+      await execInherit("systemctl", ["--user", "restart", "volute"]);
+      break;
+    case "user-launchd":
+      try {
+        await execInherit("launchctl", ["unload", LAUNCHD_PLIST_PATH]);
+      } catch (err) {
+        console.warn(
+          `Warning: launchctl unload failed: ${err instanceof Error ? err.message : err}`
+        );
+      }
+      await execInherit("launchctl", ["load", LAUNCHD_PLIST_PATH]);
+      break;
+  }
+}
+function readDaemonConfig() {
+  const configPath = resolve(voluteHome(), "daemon.json");
+  if (!existsSync(configPath)) return { hostname: "127.0.0.1", port: 4200 };
+  try {
+    const config = JSON.parse(readFileSync(configPath, "utf-8"));
+    return {
+      hostname: config.hostname || "127.0.0.1",
+      port: config.port ?? 4200,
+      token: config.token
+    };
+  } catch {
+    console.error("Warning: could not read daemon config, using defaults.");
+    return { hostname: "127.0.0.1", port: 4200 };
+  }
+}
+function modeLabel(mode) {
+  switch (mode) {
+    case "system":
+      return "system service (systemd)";
+    case "user-systemd":
+      return "user service (systemd)";
+    case "user-launchd":
+      return "user service (launchd)";
+    case "manual":
+      return "manual";
+  }
+}
+
+export {
+  SYSTEM_SERVICE_PATH,
+  USER_SYSTEMD_UNIT,
+  LAUNCHD_PLIST_LABEL,
+  LAUNCHD_PLIST_PATH,
+  getServiceMode,
+  getDaemonUrl,
+  pollHealth,
+  pollHealthDown,
+  startService,
+  stopService,
+  restartService,
+  readDaemonConfig,
+  modeLabel
+};

package/dist/{chunk-M5AEQLB3.js → chunk-34GBEBQH.js}

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  getServiceMode,
+  modeLabel,
+  pollHealth,
+  startService
+} from "./chunk-25GGN3OV.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -7,7 +13,7 @@ import {
 } from "./chunk-DP2DX4WV.js";
 
 // src/commands/up.ts
-import { execFileSync, spawn } from "child_process";
+import { spawn } from "child_process";
 import { existsSync, mkdirSync, openSync, readFileSync } from "fs";
 import { dirname, resolve } from "path";
 function readGlobalConfig() {
@@ -20,26 +26,31 @@ function readGlobalConfig() {
     process.exit(1);
   }
 }
-function isSystemdServiceEnabled() {
-  try {
-    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
-    return true;
-  } catch {
-    return false;
-  }
-}
 async function run(args) {
   const { flags } = parseArgs(args, {
     port: { type: "number" },
     host: { type: "string" },
     foreground: { type: "boolean" }
   });
-  if (!flags.foreground && isSystemdServiceEnabled()) {
-    console.error("Volute is managed by a systemd service.");
-    console.error("Use: sudo systemctl start volute");
-    console.error("     sudo systemctl restart volute");
-    console.error("     systemctl status volute");
-    process.exit(1);
+  const mode = getServiceMode();
+  if (!flags.foreground && mode !== "manual") {
+    console.log(`Starting volute (${modeLabel(mode)})...`);
+    try {
+      await startService(mode);
+    } catch (err) {
+      console.error(`Failed to start service: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+    const config2 = readGlobalConfig();
+    const h = flags.host ?? config2.hostname ?? "127.0.0.1";
+    const p = flags.port ?? config2.port ?? 4200;
+    if (await pollHealth(h, p)) {
+      console.log(`Volute daemon running on ${h}:${p}`);
+    } else {
+      console.error("Service started but daemon did not become healthy within 30s.");
+      process.exit(1);
+    }
+    return;
   }
   const config = readGlobalConfig();
   const port = flags.port ?? config.port ?? 4200;
@@ -59,10 +70,13 @@ async function run(args) {
   try {
     const res = await fetch(`http://${pollHost}:${port}/api/health`);
     if (res.ok) {
-      console.error(
-        `Port ${port} is already in use by a Volute daemon. Use 'volute down' first, or kill the process on that port.`
-      );
-      process.exit(1);
+      const body = await res.json().catch(() => null);
+      if (body && body.ok) {
+        console.error(
+          `Port ${port} is already in use by a Volute daemon. Use 'volute down' first, or kill the process on that port.`
+        );
+        process.exit(1);
+      }
     }
   } catch {
   }

package/dist/{chunk-FYQGANL6.js → chunk-GGLTM53H.js}

@@ -1,31 +1,19 @@
 #!/usr/bin/env node
 import {
-  daemonFetch
-} from "./chunk-STOEJOJO.js";
+  getServiceMode,
+  modeLabel,
+  pollHealthDown,
+  readDaemonConfig,
+  stopService
+} from "./chunk-25GGN3OV.js";
 import {
   voluteHome
 } from "./chunk-DP2DX4WV.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
 
 // src/commands/down.ts
-import { execFileSync } from "child_process";
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { resolve } from "path";
-function isSystemdServiceEnabled() {
-  try {
-    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
-    return true;
-  } catch {
-    return false;
-  }
-}
 async function stopDaemon() {
-  if (isSystemdServiceEnabled()) {
-    return { stopped: false, reason: "systemd" };
-  }
   const home = voluteHome();
   const pidPath = resolve(home, "daemon.pid");
   if (!existsSync(pidPath)) {
@@ -82,7 +70,7 @@ async function stopDaemon() {
       console.error(
         `Failed to send SIGTERM to daemon (pid ${pid}): ${e instanceof Error ? e.message : e}`
       );
-      return { stopped: false, reason: "kill-failed", port: pid };
+      return { stopped: false, reason: "kill-failed" };
     }
   }
   const maxWait = 1e4;
@@ -116,49 +104,34 @@ async function stopDaemon() {
   return { stopped: true, clean: false };
 }
 async function run(_args) {
-  const result = await stopDaemon();
-  if (result.stopped) return;
-  if (result.reason === "systemd") {
-    const client = getClient();
-    await daemonFetch(urlOf(client.api.system.stop.$url()), { method: "POST" });
-    const home = voluteHome();
-    const configPath = resolve(home, "daemon.json");
-    let hostname = "localhost";
-    let port = 4200;
-    if (existsSync(configPath)) {
-      try {
-        const config = JSON.parse(readFileSync(configPath, "utf-8"));
-        hostname = config.hostname || "localhost";
-        port = config.port ?? 4200;
-      } catch {
-      }
+  const mode = getServiceMode();
+  if (mode !== "manual") {
+    console.log(`Stopping volute (${modeLabel(mode)})...`);
+    try {
+      await stopService(mode);
+    } catch (err) {
+      console.error(`Failed to stop service: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
     }
-    if (hostname === "0.0.0.0") hostname = "127.0.0.1";
-    if (hostname === "::") hostname = "[::1]";
-    const url = new URL("http://localhost");
-    url.hostname = hostname;
-    url.port = String(port);
-    const healthUrl = `${url.origin}/api/health`;
-    const maxWait = 1e4;
-    const start = Date.now();
-    while (Date.now() - start < maxWait) {
-      await new Promise((r) => setTimeout(r, 500));
-      try {
-        await fetch(healthUrl);
-      } catch {
-        console.log("Daemon stopped.");
-        return;
-      }
+    const { hostname, port } = readDaemonConfig();
+    if (await pollHealthDown(hostname, port)) {
+      console.log("Daemon stopped.");
+    } else {
+      console.error("Service stopped but daemon may still be responding.");
+      process.exit(1);
     }
-    console.error("Daemon may not have stopped. Check with: volute service status");
-    process.exit(1);
-  } else if (result.reason === "orphan") {
+    return;
+  }
+  const result = await stopDaemon();
+  if (result.stopped) return;
+  if (result.reason === "orphan") {
     console.error(`Daemon appears to be running on port ${result.port} but PID file is missing.`);
     console.error(`Kill the process manually: lsof -ti :${result.port} | xargs kill`);
-  } else if (result.reason === "not-running") {
-    console.error("Daemon is not running (no PID file found).");
+    process.exit(1);
+  } else if (result.reason === "kill-failed") {
+    process.exit(1);
   }
-  process.exit(1);
+  console.log("Daemon is not running.");
 }
 
 export {

package/dist/cli.js

@@ -9,13 +9,13 @@ if (!process.env.VOLUTE_HOME) {
 var command = process.argv[2];
 var args = process.argv.slice(3);
 if (command === "--version" || command === "-v") {
-  const { default: pkg } = await import("./package-TNE337RE.js");
+  const { default: pkg } = await import("./package-4QEVVIDG.js");
   console.log(pkg.version);
   process.exit(0);
 }
 switch (command) {
   case "agent":
-    await import("./agent-ECRX44DB.js").then((m) => m.run(args));
+    await import("./agent-JGO6N7IA.js").then((m) => m.run(args));
     break;
   case "send":
     await import("./send-X6OQGSD6.js").then((m) => m.run(args));
@@ -39,22 +39,25 @@ switch (command) {
     await import("./env-CGORIKVF.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-FCYL2IPZ.js").then((m) => m.run(args));
+    await import("./up-6ORVZLBR.js").then((m) => m.run(args));
     break;
   case "down":
-    await import("./down-4LIQG3CE.js").then((m) => m.run(args));
+    await import("./down-XV2OQJ7O.js").then((m) => m.run(args));
     break;
   case "restart":
-    await import("./daemon-restart-7X72OXOW.js").then((m) => m.run(args));
+    await import("./daemon-restart-BO25T4J6.js").then((m) => m.run(args));
     break;
   case "setup":
-    await import("./setup-6QFIHXSH.js").then((m) => m.run(args));
+    await import("./setup-GMZOD52B.js").then((m) => m.run(args));
     break;
   case "service":
-    await import("./service-OW35VZ5G.js").then((m) => m.run(args));
+    await import("./service-U6SN5OZO.js").then((m) => m.run(args));
     break;
   case "update":
-    await import("./update-3TGXUTO2.js").then((m) => m.run(args));
+    await import("./update-BPKQX5OY.js").then((m) => m.run(args));
+    break;
+  case "status":
+    await import("./status-CTWXP6UW.js").then((m) => m.run(args));
     break;
   case "--help":
   case "-h":
@@ -106,6 +109,7 @@ Commands:
   volute setup uninstall [--force]        Remove system service + isolation
 
   volute update                           Update to latest version
+  volute status                           Show daemon status and agents
 
 Options:
   --version, -v                           Show version number

package/dist/daemon-restart-BO25T4J6.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import {
+  run
+} from "./chunk-34GBEBQH.js";
+import {
+  stopDaemon
+} from "./chunk-GGLTM53H.js";
+import {
+  getServiceMode,
+  modeLabel,
+  pollHealth,
+  readDaemonConfig,
+  restartService
+} from "./chunk-25GGN3OV.js";
+import "./chunk-5C5JWR2L.js";
+import "./chunk-D424ZQGI.js";
+import "./chunk-DP2DX4WV.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/daemon-restart.ts
+async function run2(args) {
+  const mode = getServiceMode();
+  if (mode !== "manual") {
+    console.log(`Restarting volute (${modeLabel(mode)})...`);
+    try {
+      await restartService(mode);
+    } catch (err) {
+      console.error(`Failed to restart service: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+    const { hostname, port } = readDaemonConfig();
+    if (await pollHealth(hostname, port)) {
+      console.log("Daemon restarted.");
+    } else {
+      console.error("Service restarted but daemon did not become healthy within 30s.");
+      process.exit(1);
+    }
+    return;
+  }
+  const result = await stopDaemon();
+  if (!result.stopped && result.reason === "kill-failed") {
+    console.error("Cannot restart: failed to stop the running daemon.");
+    process.exit(1);
+  }
+  await run(args);
+}
+export {
+  run2 as run
+};

package/dist/daemon.js

@@ -7,11 +7,6 @@ import {
   loadJsonMap,
   saveJsonMap
 } from "./chunk-KR6WRAJ4.js";
-import {
-  checkForUpdate,
-  checkForUpdateCached,
-  getCurrentVersion
-} from "./chunk-RT6Y7AR3.js";
 import {
   applyIsolation,
   chownAgentDir,
@@ -21,10 +16,6 @@ import {
   getAgentUserIds,
   isIsolationEnabled
 } from "./chunk-46S7YHUB.js";
-import {
-  exec,
-  resolveVoluteBin
-} from "./chunk-5C5JWR2L.js";
 import {
   findOpenClawSession,
   importOpenClawConnectors,
@@ -44,6 +35,15 @@ import {
   CHANNELS,
   getChannelDriver
 } from "./chunk-LIPPXNIE.js";
+import {
+  exec,
+  resolveVoluteBin
+} from "./chunk-5C5JWR2L.js";
+import {
+  checkForUpdate,
+  checkForUpdateCached,
+  getCurrentVersion
+} from "./chunk-RT6Y7AR3.js";
 import "./chunk-D424ZQGI.js";
 import {
   slugify,

package/dist/{down-4LIQG3CE.js → down-XV2OQJ7O.js}

@@ -2,10 +2,10 @@
 import {
   run,
   stopDaemon
-} from "./chunk-FYQGANL6.js";
-import "./chunk-STOEJOJO.js";
+} from "./chunk-GGLTM53H.js";
+import "./chunk-25GGN3OV.js";
+import "./chunk-5C5JWR2L.js";
 import "./chunk-DP2DX4WV.js";
-import "./chunk-4RQBJWQX.js";
 import "./chunk-K3NQKI34.js";
 export {
   run,

package/dist/{package-TNE337RE.js → package-4QEVVIDG.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.10.1",
+  version: "0.11.0",
   description: "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",
@@ -20,7 +20,7 @@ var package_default = {
     "anthropic"
   ],
   engines: {
-    node: ">=22"
+    node: ">=24"
   },
   bin: {
     volute: "dist/cli.js"

package/dist/{service-OW35VZ5G.js → service-U6SN5OZO.js}

@@ -1,10 +1,17 @@
 #!/usr/bin/env node
+import {
+  LAUNCHD_PLIST_LABEL,
+  LAUNCHD_PLIST_PATH,
+  SYSTEM_SERVICE_PATH,
+  USER_SYSTEMD_UNIT
+} from "./chunk-25GGN3OV.js";
 import {
   resolveVoluteBin
 } from "./chunk-5C5JWR2L.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/service.ts
@@ -15,7 +22,6 @@ import { resolve } from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
 var HOST_RE = /^[a-zA-Z0-9.:_-]+$/;
-var SYSTEM_SERVICE_PATH = "/etc/systemd/system/volute.service";
 function validateHost(host) {
   if (!HOST_RE.test(host)) {
     throw new Error(`Invalid host: ${host}`);
@@ -24,8 +30,6 @@ function validateHost(host) {
 function escapeXml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-var PLIST_LABEL = "com.volute.daemon";
-var plistPath = () => resolve(homedir(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
 function generatePlist(voluteBin, port, host) {
   const args = ["up", "--foreground"];
   if (port != null) args.push("--port", String(port));
@@ -35,7 +39,7 @@ function generatePlist(voluteBin, port, host) {
 <plist version="1.0">
 <dict>
   <key>Label</key>
-  <string>${PLIST_LABEL}</string>
+  <string>${LAUNCHD_PLIST_LABEL}</string>
   <key>ProgramArguments</key>
   <array>
     ${[voluteBin, ...args].map((a) => `<string>${escapeXml(a)}</string>`).join("\n    ")}
@@ -51,8 +55,6 @@ function generatePlist(voluteBin, port, host) {
 </dict>
 </plist>`;
 }
-var unitName = "volute.service";
-var unitPath = () => resolve(homedir(), ".config", "systemd", "user", unitName);
 function generateUnit(voluteBin, port, host) {
   const args = ["up", "--foreground"];
   if (port != null) args.push("--port", String(port));
@@ -76,7 +78,7 @@ async function install(port, host) {
   const voluteBin = resolveVoluteBin();
   const platform = process.platform;
   if (platform === "darwin") {
-    const path = plistPath();
+    const path = LAUNCHD_PLIST_PATH;
     mkdirSync(resolve(homedir(), "Library", "LaunchAgents"), { recursive: true });
     writeFileSync(path, generatePlist(voluteBin, port, host));
     console.log(`Wrote ${path}`);
@@ -96,7 +98,7 @@ async function install(port, host) {
       console.error("Use `volute setup` instead to install a system-level service.");
       process.exit(1);
     }
-    const path = unitPath();
+    const path = USER_SYSTEMD_UNIT;
     mkdirSync(resolve(homedir(), ".config", "systemd", "user"), { recursive: true });
     writeFileSync(path, generateUnit(voluteBin, port, host));
     console.log(`Wrote ${path}`);
@@ -110,7 +112,7 @@ async function install(port, host) {
 async function uninstall() {
   const platform = process.platform;
   if (platform === "darwin") {
-    const path = plistPath();
+    const path = LAUNCHD_PLIST_PATH;
     if (existsSync(path)) {
       try {
         await execFileAsync("launchctl", ["unload", path]);
@@ -123,7 +125,7 @@ async function uninstall() {
       console.log("Service not installed.");
     }
   } else if (platform === "linux") {
-    const path = unitPath();
+    const path = USER_SYSTEMD_UNIT;
     if (existsSync(path)) {
       try {
         await execFileAsync("systemctl", ["--user", "disable", "--now", "volute"]);
@@ -143,12 +145,12 @@ async function uninstall() {
 async function status() {
   const platform = process.platform;
   if (platform === "darwin") {
-    if (!existsSync(plistPath())) {
+    if (!existsSync(LAUNCHD_PLIST_PATH)) {
       console.log("Service not installed.");
       return;
     }
     try {
-      const { stdout } = await execFileAsync("launchctl", ["list", PLIST_LABEL]);
+      const { stdout } = await execFileAsync("launchctl", ["list", LAUNCHD_PLIST_LABEL]);
       console.log(stdout);
     } catch {
       console.log("Service installed but not currently loaded.");
@@ -171,7 +173,7 @@ async function status() {
       }
       return;
     }
-    if (!existsSync(unitPath())) {
+    if (!existsSync(USER_SYSTEMD_UNIT)) {
       console.log("Service not installed.");
       return;
     }

package/dist/{setup-6QFIHXSH.js → setup-GMZOD52B.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  SYSTEM_SERVICE_PATH
+} from "./chunk-25GGN3OV.js";
 import {
   ensureVoluteGroup
 } from "./chunk-46S7YHUB.js";
@@ -17,11 +20,11 @@ import { existsSync, mkdirSync, rmSync, unlinkSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname } from "path";
 var SERVICE_NAME = "volute.service";
-var SERVICE_PATH = `/etc/systemd/system/${SERVICE_NAME}`;
 var PROFILE_PATH = "/etc/profile.d/volute.sh";
 var WRAPPER_PATH = "/usr/local/bin/volute";
 var DATA_DIR = "/var/lib/volute";
 var AGENTS_DIR = "/agents";
+var CLAUDE_DIR = `${DATA_DIR}/.claude`;
 var HOST_RE = /^[a-zA-Z0-9.:_-]+$/;
 function validateHost(host) {
   if (!HOST_RE.test(host)) {
@@ -59,10 +62,11 @@ function generateUnit(voluteBin, port, host) {
     `Environment=VOLUTE_HOME=${DATA_DIR}`,
     `Environment=VOLUTE_AGENTS_DIR=${AGENTS_DIR}`,
     "Environment=VOLUTE_ISOLATION=user",
+    `Environment=CLAUDE_CONFIG_DIR=${CLAUDE_DIR}`,
     "Restart=on-failure",
     "RestartSec=5",
-    "ProtectSystem=strict",
-    `ReadWritePaths=${DATA_DIR} ${AGENTS_DIR} /etc`,
+    "ProtectSystem=true",
+    `ReadWritePaths=${DATA_DIR} ${AGENTS_DIR}`,
     "PrivateTmp=yes"
   ];
   if (!binUnderHome) {
@@ -92,6 +96,10 @@ function install(port, host) {
   console.log(`Created ${AGENTS_DIR}`);
   ensureVoluteGroup({ force: true });
   console.log("Ensured volute group exists");
+  mkdirSync(CLAUDE_DIR, { recursive: true });
+  execFileSync("chown", ["root:volute", CLAUDE_DIR]);
+  execFileSync("chmod", ["750", CLAUDE_DIR]);
+  console.log(`Created ${CLAUDE_DIR}`);
   execFileSync("chmod", ["755", DATA_DIR]);
   execFileSync("chmod", ["755", AGENTS_DIR]);
   console.log("Set permissions on directories");
@@ -113,13 +121,13 @@ exec "${voluteBin}" "$@"
     writeFileSync(WRAPPER_PATH, wrapper, { mode: 493 });
     console.log(`Wrote ${WRAPPER_PATH} (wrapper for ${voluteBin})`);
   }
-  writeFileSync(SERVICE_PATH, generateUnit(voluteBin, port, host ?? "0.0.0.0"));
-  console.log(`Wrote ${SERVICE_PATH}`);
+  writeFileSync(SYSTEM_SERVICE_PATH, generateUnit(voluteBin, port, host ?? "0.0.0.0"));
+  console.log(`Wrote ${SYSTEM_SERVICE_PATH}`);
   try {
     execFileSync("systemctl", ["daemon-reload"]);
   } catch (err) {
     const e = err;
-    console.error(`Failed to reload systemd after writing ${SERVICE_PATH}.`);
+    console.error(`Failed to reload systemd after writing ${SYSTEM_SERVICE_PATH}.`);
     if (e.stderr) console.error(e.stderr.toString().trim());
     console.error(
       "Try running `systemctl daemon-reload` manually, then `systemctl enable --now volute`."
@@ -129,9 +137,16 @@ exec "${voluteBin}" "$@"
   try {
     execFileSync("systemctl", ["enable", "--now", SERVICE_NAME]);
     console.log("Service installed, enabled, and started.");
+    console.log(
+      "Run `source /etc/profile.d/volute.sh` or start a new shell to use volute CLI commands."
+    );
     console.log(`
 Volute daemon is running. Data directory: ${DATA_DIR}`);
     console.log("Use `systemctl status volute` to check status.");
+    console.log(
+      `
+For agent-sdk agents, copy ~/.claude/.credentials.json to ${CLAUDE_DIR}/.credentials.json`
+    );
   } catch (err) {
     const e = err;
     console.error("Service installed but failed to start.");
@@ -145,7 +160,7 @@ function uninstall(force) {
     console.error("Error: volute setup uninstall must be run as root (use sudo).");
     process.exit(1);
   }
-  if (!existsSync(SERVICE_PATH)) {
+  if (!existsSync(SYSTEM_SERVICE_PATH)) {
     console.log("Service not installed.");
     return;
   }
@@ -154,7 +169,7 @@ function uninstall(force) {
   } catch {
     console.warn("Warning: failed to disable service (may already be stopped)");
   }
-  unlinkSync(SERVICE_PATH);
+  unlinkSync(SYSTEM_SERVICE_PATH);
   if (existsSync(PROFILE_PATH)) unlinkSync(PROFILE_PATH);
   if (existsSync(WRAPPER_PATH)) unlinkSync(WRAPPER_PATH);
   try {

package/dist/status-CTWXP6UW.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import {
+  getDaemonUrl,
+  getServiceMode,
+  modeLabel,
+  readDaemonConfig
+} from "./chunk-25GGN3OV.js";
+import "./chunk-5C5JWR2L.js";
+import {
+  checkForUpdate
+} from "./chunk-RT6Y7AR3.js";
+import "./chunk-DP2DX4WV.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/status.ts
+async function run(_args) {
+  const mode = getServiceMode();
+  console.log(`Mode: ${modeLabel(mode)}`);
+  const { hostname, port, token } = readDaemonConfig();
+  const baseUrl = getDaemonUrl(hostname, port);
+  let running = false;
+  let version;
+  try {
+    const res = await fetch(`${baseUrl}/api/health`);
+    if (res.ok) {
+      const body = await res.json();
+      if (body.ok) {
+        running = true;
+        version = body.version;
+      }
+    }
+  } catch {
+  }
+  if (!running) {
+    console.log("Status: not running");
+    return;
+  }
+  console.log(`Status: running on ${hostname}:${port}`);
+  if (version) console.log(`Version: ${version}`);
+  const update = await checkForUpdate();
+  if (update.updateAvailable) {
+    console.log(`Update available: ${update.current} \u2192 ${update.latest}`);
+  }
+  const headers = {};
+  if (token) headers.Authorization = `Bearer ${token}`;
+  headers.Origin = baseUrl;
+  try {
+    const res = await fetch(`${baseUrl}/api/agents`, { headers });
+    if (res.ok) {
+      const agents = await res.json();
+      if (agents.length > 0) {
+        console.log(`
+Agents (${agents.length}):`);
+        for (const agent of agents) {
+          const status = agent.running ? "running" : "stopped";
+          console.log(`  ${agent.name}: ${status}`);
+        }
+      } else {
+        console.log("\nNo agents configured.");
+      }
+    }
+  } catch {
+  }
+}
+export {
+  run
+};

package/dist/{up-FCYL2IPZ.js → up-6ORVZLBR.js}

@@ -2,7 +2,9 @@
 import {
   readGlobalConfig,
   run
-} from "./chunk-M5AEQLB3.js";
+} from "./chunk-34GBEBQH.js";
+import "./chunk-25GGN3OV.js";
+import "./chunk-5C5JWR2L.js";
 import "./chunk-D424ZQGI.js";
 import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";

package/dist/{update-3TGXUTO2.js → update-BPKQX5OY.js}

@@ -1,30 +1,28 @@
 #!/usr/bin/env node
 import {
-  checkForUpdate
-} from "./chunk-RT6Y7AR3.js";
+  getServiceMode,
+  modeLabel,
+  pollHealth,
+  readDaemonConfig,
+  restartService
+} from "./chunk-25GGN3OV.js";
 import {
+  exec,
   execInherit,
   resolveVoluteBin
 } from "./chunk-5C5JWR2L.js";
+import {
+  checkForUpdate
+} from "./chunk-RT6Y7AR3.js";
 import {
   voluteHome
 } from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/update.ts
-import { execFileSync } from "child_process";
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { resolve } from "path";
 async function run(_args) {
-  try {
-    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
-    console.error("Volute is managed by a systemd service.");
-    console.error("To update, run:");
-    console.error("  sudo npm install -g volute@latest");
-    console.error("  sudo systemctl restart volute");
-    process.exit(1);
-  } catch {
-  }
   const result = await checkForUpdate();
   if (result.checkFailed) {
     console.error("Could not reach npm registry. Check your network connection and try again.");
@@ -38,6 +36,71 @@ async function run(_args) {
   }
   console.log(`
 Updating volute ${result.current} \u2192 ${result.latest}...`);
+  const mode = getServiceMode();
+  if (mode === "system") {
+    let npmPath = "/usr/bin/npm";
+    if (!existsSync(npmPath)) {
+      try {
+        npmPath = (await exec("which", ["npm"])).trim();
+      } catch {
+        console.error("Could not find npm. Install npm and try again.");
+        process.exit(1);
+      }
+    }
+    try {
+      await execInherit("sudo", [npmPath, "install", "-g", "volute@latest"]);
+    } catch (err) {
+      console.error(`
+Update failed: ${err.message}`);
+      process.exit(1);
+    }
+    console.log("Restarting service...");
+    try {
+      await restartService(mode);
+    } catch (err) {
+      console.error(`Failed to restart: ${err instanceof Error ? err.message : err}`);
+      console.error("Try: sudo systemctl restart volute");
+      process.exit(1);
+    }
+    {
+      const { hostname, port } = readDaemonConfig();
+      if (await pollHealth(hostname, port)) {
+        console.log(`
+Updated to volute v${result.latest}`);
+      } else {
+        console.error("Service restarted but daemon did not become healthy.");
+        process.exit(1);
+      }
+    }
+    return;
+  }
+  if (mode === "user-systemd" || mode === "user-launchd") {
+    try {
+      await execInherit("npm", ["install", "-g", "volute@latest"]);
+    } catch (err) {
+      console.error(`
+Update failed: ${err.message}`);
+      process.exit(1);
+    }
+    console.log(`Restarting service (${modeLabel(mode)})...`);
+    try {
+      await restartService(mode);
+    } catch (err) {
+      console.error(`Failed to restart: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+    {
+      const { hostname, port } = readDaemonConfig();
+      if (await pollHealth(hostname, port)) {
+        console.log(`
+Updated to volute v${result.latest}`);
+      } else {
+        console.error("Service restarted but daemon did not become healthy.");
+        process.exit(1);
+      }
+    }
+    return;
+  }
   const home = voluteHome();
   const pidPath = resolve(home, "daemon.pid");
   const configPath = resolve(home, "daemon.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",
@@ -16,7 +16,7 @@
     "anthropic"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "bin": {
     "volute": "dist/cli.js"

package/dist/daemon-restart-7X72OXOW.js

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-import {
-  run
-} from "./chunk-M5AEQLB3.js";
-import {
-  stopDaemon
-} from "./chunk-FYQGANL6.js";
-import "./chunk-D424ZQGI.js";
-import {
-  daemonFetch
-} from "./chunk-STOEJOJO.js";
-import {
-  voluteHome
-} from "./chunk-DP2DX4WV.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/daemon-restart.ts
-import { readFileSync } from "fs";
-import { resolve } from "path";
-async function run2(args) {
-  const result = await stopDaemon();
-  if (!result.stopped && result.reason === "systemd") {
-    const client = getClient();
-    await daemonFetch(urlOf(client.api.system.restart.$url()), { method: "POST" });
-    const config = JSON.parse(readFileSync(resolve(voluteHome(), "daemon.json"), "utf-8"));
-    let hostname = config.hostname || "localhost";
-    if (hostname === "0.0.0.0") hostname = "127.0.0.1";
-    if (hostname === "::") hostname = "[::1]";
-    const url = new URL("http://localhost");
-    url.hostname = hostname;
-    url.port = String(config.port ?? 4200);
-    const healthUrl = `${url.origin}/api/health`;
-    const maxWait = 15e3;
-    const start = Date.now();
-    while (Date.now() - start < maxWait) {
-      try {
-        const res = await fetch(healthUrl);
-        if (res.ok) {
-          console.log("Daemon restarted.");
-          return;
-        }
-      } catch {
-      }
-      await new Promise((r) => setTimeout(r, 500));
-    }
-    console.error("Daemon did not restart within 15s. Check logs.");
-    process.exit(1);
-  }
-  if (!result.stopped && result.reason === "kill-failed") {
-    console.error("Cannot restart: failed to stop the running daemon.");
-    process.exit(1);
-  }
-  await run(args);
-}
-export {
-  run2 as run
-};

package/dist/status-SIMKH3ZE.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-import {
-  daemonFetch
-} from "./chunk-STOEJOJO.js";
-import "./chunk-DP2DX4WV.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/status.ts
-async function run(args) {
-  const name = args[0];
-  const client = getClient();
-  if (!name) {
-    const res2 = await daemonFetch(urlOf(client.api.agents.$url()));
-    if (!res2.ok) {
-      const data = await res2.json();
-      console.error(data.error ?? `Failed to get status: ${res2.status}`);
-      process.exit(1);
-    }
-    const agents = await res2.json();
-    if (agents.length === 0) {
-      console.log("No agents registered. Create one with: volute agent create <name>");
-      return;
-    }
-    const nameW = Math.max(4, ...agents.map((a) => a.name.length));
-    const portW = Math.max(4, ...agents.map((a) => String(a.port).length));
-    console.log(`${"NAME".padEnd(nameW)}  ${"PORT".padEnd(portW)}  STATUS    CONNECTORS`);
-    for (const agent2 of agents) {
-      const connected = agent2.channels.filter((ch) => ch.status === "connected").map((ch) => ch.name);
-      const connectors = connected.length > 0 ? connected.join(", ") : "-";
-      console.log(
-        `${agent2.name.padEnd(nameW)}  ${String(agent2.port).padEnd(portW)}  ${agent2.status.padEnd(8)}  ${connectors}`
-      );
-    }
-    return;
-  }
-  const res = await daemonFetch(urlOf(client.api.agents[":name"].$url({ param: { name } })));
-  if (!res.ok) {
-    const data = await res.json();
-    console.error(data.error || `Failed to get status for ${name}`);
-    process.exit(1);
-  }
-  const agent = await res.json();
-  console.log(`Agent: ${agent.name}`);
-  console.log(`Port: ${agent.port}`);
-  console.log(`Status: ${agent.status}`);
-  for (const ch of agent.channels) {
-    console.log(`${ch.name}: ${ch.status}`);
-  }
-  if (agent.variants && agent.variants.length > 0) {
-    console.log("");
-    console.log("Variants:");
-    for (const v of agent.variants) {
-      console.log(`  ${v.name}  port=${v.port}  ${v.status}`);
-    }
-  }
-}
-export {
-  run
-};