@openacp/cli 2026.330.3 → 2026.331.1

package/dist/cli.js

@@ -3,7 +3,15 @@ import {
   apiCall,
   readApiPort,
   removeStalePortFile
-} from "./chunk-4WXALZA3.js";
+} from "./chunk-XRJUS6FE.js";
+import {
+  InstanceRegistry
+} from "./chunk-23SRIVG4.js";
+import {
+  createInstanceContext,
+  getGlobalRoot,
+  resolveInstanceRoot
+} from "./chunk-ON7HB5O7.js";
 import {
   checkAndPromptUpdate,
   compareVersions,
@@ -11,13 +19,10 @@ import {
   getLatestVersion,
   runUpdate
 } from "./chunk-S64CB6J3.js";
-import {
-  PLUGINS_DIR
-} from "./chunk-W4LK6WJP.js";
-import "./chunk-R6KZYF7D.js";
 
 // src/cli.ts
 import { setDefaultAutoSelectFamily } from "net";
+import path9 from "path";
 
 // src/cli/commands/help.ts
 function printHelp() {
@@ -93,6 +98,13 @@ Connect messaging platforms (Telegram, Discord) to 28+ AI coding agents via ACP
   openacp api health                   System health check
   openacp api restart                  Restart daemon
 
+\x1B[1mInstance Flags:\x1B[0m
+  --local              Use setup in current directory
+  --global             Use main setup (~/.openacp)
+  --dir <path>         Use setup in specified directory
+  --from <path>        Copy settings from existing setup (on create)
+  --name <name>        Set instance name (on create)
+
 \x1B[2mMore info: https://github.com/Open-ACP/OpenACP\x1B[0m
 `);
 }
@@ -107,6 +119,7 @@ async function cmdVersion() {
 import { execSync } from "child_process";
 import * as fs from "fs";
 import * as path from "path";
+import * as os from "os";
 
 // src/cli/commands/helpers.ts
 function wantsHelp(args2) {
@@ -125,7 +138,9 @@ function buildNestedUpdateFromPath(dotPath, value) {
 }
 
 // src/cli/commands/install.ts
-async function cmdInstall(args2) {
+async function cmdInstall(args2, instanceRoot) {
+  const root2 = instanceRoot ?? path.join(os.homedir(), ".openacp");
+  const pluginsDir = path.join(root2, "plugins");
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp install\x1B[0m \u2014 Install a plugin adapter
@@ -148,13 +163,13 @@ Installs the plugin to ~/.openacp/plugins/.
     console.error("Usage: openacp install <package>");
     process.exit(1);
   }
-  fs.mkdirSync(PLUGINS_DIR, { recursive: true });
-  const pkgPath = path.join(PLUGINS_DIR, "package.json");
+  fs.mkdirSync(pluginsDir, { recursive: true });
+  const pkgPath = path.join(pluginsDir, "package.json");
   if (!fs.existsSync(pkgPath)) {
     fs.writeFileSync(pkgPath, JSON.stringify({ name: "openacp-plugins", private: true, dependencies: {} }, null, 2));
   }
   console.log(`Installing ${pkg}...`);
-  execSync(`npm install ${pkg} --prefix "${PLUGINS_DIR}"`, { stdio: "inherit" });
+  execSync(`npm install ${pkg} --prefix "${pluginsDir}"`, { stdio: "inherit" });
   console.log(`Plugin ${pkg} installed successfully.`);
 }
 
@@ -162,7 +177,10 @@ Installs the plugin to ~/.openacp/plugins/.
 import { execSync as execSync2 } from "child_process";
 import * as fs2 from "fs";
 import * as path2 from "path";
-async function cmdUninstall(args2) {
+import * as os2 from "os";
+async function cmdUninstall(args2, instanceRoot) {
+  const root2 = instanceRoot ?? path2.join(os2.homedir(), ".openacp");
+  const pluginsDir = path2.join(root2, "plugins");
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp uninstall\x1B[0m \u2014 Remove a plugin adapter
@@ -183,18 +201,18 @@ async function cmdUninstall(args2) {
     console.error("Usage: openacp uninstall <package>");
     process.exit(1);
   }
-  fs2.mkdirSync(PLUGINS_DIR, { recursive: true });
-  const pkgPath = path2.join(PLUGINS_DIR, "package.json");
+  fs2.mkdirSync(pluginsDir, { recursive: true });
+  const pkgPath = path2.join(pluginsDir, "package.json");
   if (!fs2.existsSync(pkgPath)) {
     fs2.writeFileSync(pkgPath, JSON.stringify({ name: "openacp-plugins", private: true, dependencies: {} }, null, 2));
   }
   console.log(`Uninstalling ${pkg}...`);
-  execSync2(`npm uninstall ${pkg} --prefix "${PLUGINS_DIR}"`, { stdio: "inherit" });
+  execSync2(`npm uninstall ${pkg} --prefix "${pluginsDir}"`, { stdio: "inherit" });
   console.log(`Plugin ${pkg} uninstalled.`);
 }
 
 // src/cli/commands/plugins.ts
-async function cmdPlugins(args2 = []) {
+async function cmdPlugins(args2 = [], instanceRoot) {
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp plugins\x1B[0m \u2014 List installed plugins
@@ -206,10 +224,11 @@ Shows all plugins registered in the plugin registry.
 `);
     return;
   }
-  const os2 = await import("os");
-  const path5 = await import("path");
+  const os7 = await import("os");
+  const path10 = await import("path");
   const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
-  const registryPath = path5.join(os2.homedir(), ".openacp", "plugins.json");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
+  const registryPath = path10.join(root2, "plugins.json");
   const registry = new PluginRegistry(registryPath);
   await registry.load();
   const plugins = registry.list();
@@ -223,7 +242,7 @@ Shows all plugins registered in the plugin registry.
     }
   }
 }
-async function cmdPlugin(args2 = []) {
+async function cmdPlugin(args2 = [], instanceRoot) {
   const subcommand = args2[1];
   if (wantsHelp(args2) || !subcommand) {
     console.log(`
@@ -254,7 +273,7 @@ async function cmdPlugin(args2 = []) {
   }
   switch (subcommand) {
     case "list":
-      return cmdPlugins(args2.slice(1));
+      return cmdPlugins(args2.slice(1), instanceRoot);
     case "search": {
       const { cmdPluginSearch } = await import("./plugin-search-MGKAL5JM.js");
       await cmdPluginSearch(args2.slice(2));
@@ -267,7 +286,7 @@ async function cmdPlugin(args2 = []) {
         console.error("Error: missing package name. Usage: openacp plugin add <package>");
         process.exit(1);
       }
-      await installPlugin(pkg);
+      await installPlugin(pkg, instanceRoot);
       return;
     }
     case "remove":
@@ -278,7 +297,7 @@ async function cmdPlugin(args2 = []) {
         process.exit(1);
       }
       const purge = args2.includes("--purge");
-      await uninstallPlugin(pkg, purge);
+      await uninstallPlugin(pkg, purge, instanceRoot);
       return;
     }
     case "enable": {
@@ -287,7 +306,7 @@ async function cmdPlugin(args2 = []) {
         console.error("Error: missing plugin name. Usage: openacp plugin enable <name>");
         process.exit(1);
       }
-      await setPluginEnabled(name, true);
+      await setPluginEnabled(name, true, instanceRoot);
       return;
     }
     case "disable": {
@@ -296,7 +315,7 @@ async function cmdPlugin(args2 = []) {
         console.error("Error: missing plugin name. Usage: openacp plugin disable <name>");
         process.exit(1);
       }
-      await setPluginEnabled(name, false);
+      await setPluginEnabled(name, false, instanceRoot);
       return;
     }
     case "configure": {
@@ -305,11 +324,11 @@ async function cmdPlugin(args2 = []) {
         console.error("Error: missing plugin name. Usage: openacp plugin configure <name>");
         process.exit(1);
       }
-      await configurePlugin(name);
+      await configurePlugin(name, instanceRoot);
       return;
     }
     case "create": {
-      const { cmdPluginCreate } = await import("./plugin-create-EHL76ZZG.js");
+      const { cmdPluginCreate } = await import("./plugin-create-HFKS23JY.js");
       await cmdPluginCreate();
       return;
     }
@@ -319,11 +338,12 @@ async function cmdPlugin(args2 = []) {
       process.exit(1);
   }
 }
-async function setPluginEnabled(name, enabled) {
-  const os2 = await import("os");
-  const path5 = await import("path");
+async function setPluginEnabled(name, enabled, instanceRoot) {
+  const os7 = await import("os");
+  const path10 = await import("path");
   const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
-  const registryPath = path5.join(os2.homedir(), ".openacp", "plugins.json");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
+  const registryPath = path10.join(root2, "plugins.json");
   const registry = new PluginRegistry(registryPath);
   await registry.load();
   const entry = registry.get(name);
@@ -335,18 +355,19 @@ async function setPluginEnabled(name, enabled) {
   await registry.save();
   console.log(`Plugin ${name} ${enabled ? "enabled" : "disabled"}. Restart to apply.`);
 }
-async function configurePlugin(name) {
-  const os2 = await import("os");
-  const path5 = await import("path");
-  const { corePlugins } = await import("./core-plugins-BPZY7SEB.js");
+async function configurePlugin(name, instanceRoot) {
+  const os7 = await import("os");
+  const path10 = await import("path");
+  const { corePlugins } = await import("./core-plugins-JSY2I44L.js");
   const { SettingsManager } = await import("./settings-manager-B4UN2LAC.js");
-  const { createInstallContext } = await import("./install-context-EHYV5WRY.js");
+  const { createInstallContext } = await import("./install-context-KZO5FR4D.js");
   const plugin = corePlugins.find((p) => p.name === name);
   if (!plugin) {
     console.error(`Plugin "${name}" not found.`);
     process.exit(1);
   }
-  const basePath = path5.join(os2.homedir(), ".openacp", "plugins", "data");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
+  const basePath = path10.join(root2, "plugins", "data");
   const settingsManager = new SettingsManager(basePath);
   const ctx = createInstallContext({ pluginName: name, settingsManager, basePath });
   if (plugin.configure) {
@@ -357,14 +378,15 @@ async function configurePlugin(name) {
     console.log(`Plugin ${name} has no configure or install hook.`);
   }
 }
-async function installPlugin(input) {
-  const os2 = await import("os");
-  const path5 = await import("path");
+async function installPlugin(input, instanceRoot) {
+  const os7 = await import("os");
+  const path10 = await import("path");
   const { execFileSync } = await import("child_process");
   const { getCurrentVersion: getCurrentVersion2 } = await import("./version-AXXV6IV2.js");
   const { SettingsManager } = await import("./settings-manager-B4UN2LAC.js");
-  const { createInstallContext } = await import("./install-context-EHYV5WRY.js");
+  const { createInstallContext } = await import("./install-context-KZO5FR4D.js");
   const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
   let pkgName;
   let pkgVersion;
   if (input.startsWith("@")) {
@@ -407,11 +429,11 @@ async function installPlugin(input) {
   }
   const installSpec = pkgVersion ? `${pkgName}@${pkgVersion}` : pkgName;
   console.log(`Installing ${installSpec}...`);
-  const { corePlugins } = await import("./core-plugins-BPZY7SEB.js");
+  const { corePlugins } = await import("./core-plugins-JSY2I44L.js");
   const builtinPlugin = corePlugins.find((p) => p.name === pkgName);
-  const basePath = path5.join(os2.homedir(), ".openacp", "plugins", "data");
+  const basePath = path10.join(root2, "plugins", "data");
   const settingsManager = new SettingsManager(basePath);
-  const registryPath = path5.join(os2.homedir(), ".openacp", "plugins.json");
+  const registryPath = path10.join(root2, "plugins.json");
   const pluginRegistry = new PluginRegistry(registryPath);
   await pluginRegistry.load();
   if (builtinPlugin) {
@@ -430,8 +452,8 @@ async function installPlugin(input) {
     console.log(`\u2713 ${builtinPlugin.name} installed! Restart to activate.`);
     return;
   }
-  const pluginsDir = path5.join(os2.homedir(), ".openacp", "plugins");
-  const nodeModulesDir = path5.join(pluginsDir, "node_modules");
+  const pluginsDir = path10.join(root2, "plugins");
+  const nodeModulesDir = path10.join(pluginsDir, "node_modules");
   try {
     execFileSync("npm", ["install", installSpec, "--prefix", pluginsDir, "--save"], {
       stdio: "inherit",
@@ -444,8 +466,8 @@ async function installPlugin(input) {
   const cliVersion = getCurrentVersion2();
   const isLocalPath = pkgName.startsWith("/") || pkgName.startsWith(".");
   try {
-    const pluginRoot = isLocalPath ? path5.resolve(pkgName) : path5.join(nodeModulesDir, pkgName);
-    const installedPkgPath = path5.join(pluginRoot, "package.json");
+    const pluginRoot = isLocalPath ? path10.resolve(pkgName) : path10.join(nodeModulesDir, pkgName);
+    const installedPkgPath = path10.join(pluginRoot, "package.json");
     const { readFileSync } = await import("fs");
     const installedPkg = JSON.parse(readFileSync(installedPkgPath, "utf-8"));
     const minVersion = installedPkg.engines?.openacp?.replace(/[>=^~\s]/g, "");
@@ -458,7 +480,7 @@ async function installPlugin(input) {
 `);
       }
     }
-    const pluginModule = await import(path5.join(pluginRoot, installedPkg.main ?? "dist/index.js"));
+    const pluginModule = await import(path10.join(pluginRoot, installedPkg.main ?? "dist/index.js"));
     const plugin = pluginModule.default;
     if (plugin?.install) {
       const ctx = createInstallContext({ pluginName: plugin.name ?? pkgName, settingsManager, basePath });
@@ -484,12 +506,13 @@ async function installPlugin(input) {
     console.log(`\u2713 ${pkgName} installed (npm only). Restart to activate.`);
   }
 }
-async function uninstallPlugin(name, purge) {
-  const os2 = await import("os");
-  const path5 = await import("path");
-  const fs4 = await import("fs");
+async function uninstallPlugin(name, purge, instanceRoot) {
+  const os7 = await import("os");
+  const path10 = await import("path");
+  const fs5 = await import("fs");
   const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
-  const registryPath = path5.join(os2.homedir(), ".openacp", "plugins.json");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
+  const registryPath = path10.join(root2, "plugins.json");
   const registry = new PluginRegistry(registryPath);
   await registry.load();
   const entry = registry.get(name);
@@ -502,12 +525,12 @@ async function uninstallPlugin(name, purge) {
     process.exit(1);
   }
   try {
-    const { corePlugins } = await import("./core-plugins-BPZY7SEB.js");
+    const { corePlugins } = await import("./core-plugins-JSY2I44L.js");
     const plugin = corePlugins.find((p) => p.name === name);
     if (plugin?.uninstall) {
       const { SettingsManager } = await import("./settings-manager-B4UN2LAC.js");
-      const { createInstallContext } = await import("./install-context-EHYV5WRY.js");
-      const basePath = path5.join(os2.homedir(), ".openacp", "plugins", "data");
+      const { createInstallContext } = await import("./install-context-KZO5FR4D.js");
+      const basePath = path10.join(root2, "plugins", "data");
       const settingsManager = new SettingsManager(basePath);
       const ctx = createInstallContext({ pluginName: name, settingsManager, basePath });
       await plugin.uninstall(ctx, { purge });
@@ -515,8 +538,8 @@ async function uninstallPlugin(name, purge) {
   } catch {
   }
   if (purge) {
-    const pluginDir = path5.join(os2.homedir(), ".openacp", "plugins", name);
-    fs4.rmSync(pluginDir, { recursive: true, force: true });
+    const pluginDir = path10.join(root2, "plugins", name);
+    fs5.rmSync(pluginDir, { recursive: true, force: true });
   }
   registry.remove(name);
   await registry.save();
@@ -1121,7 +1144,10 @@ Shows the version of the currently running daemon process.
 }
 
 // src/cli/commands/start.ts
-async function cmdStart(args2 = []) {
+import path3 from "path";
+import os3 from "os";
+async function cmdStart(args2 = [], instanceRoot) {
+  const root2 = instanceRoot ?? path3.join(os3.homedir(), ".openacp");
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp start\x1B[0m \u2014 Start OpenACP as a background daemon
@@ -1140,13 +1166,13 @@ Requires an existing config \u2014 run 'openacp' first to set up.
     return;
   }
   await checkAndPromptUpdate();
-  const { startDaemon, getPidPath } = await import("./daemon-XFEMMJSZ.js");
-  const { ConfigManager } = await import("./config-KN6NKKPF.js");
+  const { startDaemon, getPidPath } = await import("./daemon-UOSRDEXW.js");
+  const { ConfigManager } = await import("./config-X4UP7H6R.js");
   const cm = new ConfigManager();
   if (await cm.exists()) {
     await cm.load();
     const config = cm.get();
-    const result = startDaemon(getPidPath(), config.logging.logDir);
+    const result = startDaemon(getPidPath(root2), config.logging.logDir, root2);
     if ("error" in result) {
       console.error(result.error);
       process.exit(1);
@@ -1159,7 +1185,10 @@ Requires an existing config \u2014 run 'openacp' first to set up.
 }
 
 // src/cli/commands/stop.ts
-async function cmdStop(args2 = []) {
+import path4 from "path";
+import os4 from "os";
+async function cmdStop(args2 = [], instanceRoot) {
+  const root2 = instanceRoot ?? path4.join(os4.homedir(), ".openacp");
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp stop\x1B[0m \u2014 Stop the background daemon
@@ -1171,8 +1200,8 @@ Sends a stop signal to the running OpenACP daemon process.
 `);
     return;
   }
-  const { stopDaemon } = await import("./daemon-XFEMMJSZ.js");
-  const result = await stopDaemon();
+  const { stopDaemon, getPidPath } = await import("./daemon-UOSRDEXW.js");
+  const result = await stopDaemon(getPidPath(root2), root2);
   if (result.stopped) {
     console.log(`OpenACP daemon stopped (was PID ${result.pid})`);
   } else {
@@ -1182,25 +1211,116 @@ Sends a stop signal to the running OpenACP daemon process.
 }
 
 // src/cli/commands/status.ts
-async function cmdStatus(args2 = []) {
-  if (wantsHelp(args2)) {
-    console.log(`
-\x1B[1mopenacp status\x1B[0m \u2014 Show daemon status
-
-\x1B[1mUsage:\x1B[0m
-  openacp status
-
-Shows whether the OpenACP daemon is running and its PID.
-`);
+import fs3 from "fs";
+import path5 from "path";
+import os5 from "os";
+async function cmdStatus(args2 = [], instanceRoot) {
+  if (args2.includes("--all")) {
+    await showAllInstances();
     return;
   }
-  const { getStatus } = await import("./daemon-XFEMMJSZ.js");
-  const status = getStatus();
-  if (status.running) {
-    console.log(`OpenACP is running (PID ${status.pid})`);
+  const idIdx = args2.indexOf("--id");
+  if (idIdx !== -1 && args2[idIdx + 1]) {
+    await showInstanceById(args2[idIdx + 1]);
+    return;
+  }
+  const root2 = instanceRoot ?? getGlobalRoot();
+  await showSingleInstance(root2);
+}
+async function showAllInstances() {
+  const registryPath = path5.join(getGlobalRoot(), "instances.json");
+  const registry = new InstanceRegistry(registryPath);
+  await registry.load();
+  const instances = registry.list();
+  if (instances.length === 0) {
+    console.log("No instances registered.");
+    return;
+  }
+  console.log("");
+  console.log("  Status     ID               Name             Directory            Mode     Channels   API    Tunnel");
+  console.log("  " + "\u2500".repeat(100));
+  for (const entry of instances) {
+    const info = readInstanceInfo(entry.root);
+    const status = info.pid ? "\u25CF online" : "\u25CB offline";
+    const mode = info.pid ? info.runMode === "daemon" ? "daemon" : "fg" : "\u2014";
+    const api = info.apiPort ? String(info.apiPort) : "\u2014";
+    const tunnel = info.tunnelPort ? String(info.tunnelPort) : "\u2014";
+    const dir = entry.root.replace(/\/.openacp$/, "").replace(os5.homedir(), "~");
+    const channels = info.channels.join(", ") || "\u2014";
+    const name = info.name ?? entry.id;
+    console.log(`  ${status.padEnd(10)} ${entry.id.padEnd(16)} ${name.padEnd(16)} ${dir.padEnd(20)} ${mode.padEnd(8)} ${channels.padEnd(10)} ${api.padEnd(6)} ${tunnel}`);
+  }
+  console.log("");
+}
+async function showInstanceById(id) {
+  const registryPath = path5.join(getGlobalRoot(), "instances.json");
+  const registry = new InstanceRegistry(registryPath);
+  await registry.load();
+  const entry = registry.get(id);
+  if (!entry) {
+    console.error(`Instance "${id}" not found.`);
+    process.exit(1);
+  }
+  await showSingleInstance(entry.root);
+}
+async function showSingleInstance(root2) {
+  const info = readInstanceInfo(root2);
+  if (info.pid) {
+    console.log(`OpenACP is running (PID ${info.pid})`);
+    if (info.name) console.log(`  Name: ${info.name}`);
+    if (info.apiPort) console.log(`  API: port ${info.apiPort}`);
+    if (info.tunnelPort) console.log(`  Tunnel: port ${info.tunnelPort}`);
+    if (info.channels.length > 0) console.log(`  Channels: ${info.channels.join(", ")}`);
   } else {
-    console.log("OpenACP is not running");
+    console.log("OpenACP is not running.");
+  }
+}
+function readInstanceInfo(root2) {
+  const result = {
+    name: null,
+    pid: null,
+    apiPort: null,
+    tunnelPort: null,
+    runMode: null,
+    channels: []
+  };
+  try {
+    const config = JSON.parse(fs3.readFileSync(path5.join(root2, "config.json"), "utf-8"));
+    result.name = config.instanceName ?? null;
+    result.runMode = config.runMode ?? null;
+  } catch {
   }
+  try {
+    const pid = parseInt(fs3.readFileSync(path5.join(root2, "openacp.pid"), "utf-8").trim());
+    if (!isNaN(pid)) {
+      process.kill(pid, 0);
+      result.pid = pid;
+    }
+  } catch {
+  }
+  try {
+    const port = parseInt(fs3.readFileSync(path5.join(root2, "api.port"), "utf-8").trim());
+    if (!isNaN(port)) result.apiPort = port;
+  } catch {
+  }
+  try {
+    const tunnels = JSON.parse(fs3.readFileSync(path5.join(root2, "tunnels.json"), "utf-8"));
+    const entries = Object.values(tunnels);
+    const systemEntry = entries.find((t) => t.type === "system");
+    if (systemEntry?.port) result.tunnelPort = systemEntry.port;
+  } catch {
+  }
+  try {
+    const plugins = JSON.parse(fs3.readFileSync(path5.join(root2, "plugins.json"), "utf-8"));
+    const adapters = ["@openacp/telegram", "@openacp/discord", "@openacp/slack"];
+    for (const name of adapters) {
+      if (plugins.installed?.[name] && plugins.installed[name].enabled !== false) {
+        result.channels.push(name.replace("@openacp/", ""));
+      }
+    }
+  } catch {
+  }
+  return result;
 }
 
 // src/cli/commands/logs.ts
@@ -1220,7 +1340,7 @@ Log file location is configured in config (default: ~/.openacp/logs/).
     return;
   }
   const { spawn } = await import("child_process");
-  const { ConfigManager, expandHome } = await import("./config-KN6NKKPF.js");
+  const { ConfigManager, expandHome } = await import("./config-X4UP7H6R.js");
   const pathMod = await import("path");
   const cm = new ConfigManager();
   let logDir = "~/.openacp/logs";
@@ -1292,7 +1412,7 @@ the API for live updates. When stopped, edits config file directly.
       console.error("Usage: openacp config set <path> <value>");
       process.exit(1);
     }
-    const { ConfigSchema } = await import("./config-KN6NKKPF.js");
+    const { ConfigSchema } = await import("./config-X4UP7H6R.js");
     const topLevelKey = configPath.split(".")[0];
     const validConfigKeys = Object.keys(ConfigSchema.shape);
     if (!validConfigKeys.includes(topLevelKey)) {
@@ -1324,7 +1444,7 @@ the API for live updates. When stopped, edits config file directly.
         console.log("Note: restart required for this change to take effect.");
       }
     } else {
-      const { ConfigManager: ConfigManager2 } = await import("./config-KN6NKKPF.js");
+      const { ConfigManager: ConfigManager2 } = await import("./config-X4UP7H6R.js");
       const cm2 = new ConfigManager2();
       if (!await cm2.exists()) {
         console.error('No config found. Run "openacp" first to set up.');
@@ -1337,8 +1457,8 @@ the API for live updates. When stopped, edits config file directly.
     }
     return;
   }
-  const { runConfigEditor } = await import("./config-editor-76RVZS4B.js");
-  const { ConfigManager } = await import("./config-KN6NKKPF.js");
+  const { runConfigEditor } = await import("./config-editor-7BENRVG5.js");
+  const { ConfigManager } = await import("./config-X4UP7H6R.js");
   const cm = new ConfigManager();
   if (!await cm.exists()) {
     console.error('No config found. Run "openacp" first to set up.');
@@ -1353,7 +1473,7 @@ the API for live updates. When stopped, edits config file directly.
 }
 
 // src/cli/commands/reset.ts
-async function cmdReset(args2 = []) {
+async function cmdReset(args2 = [], instanceRoot) {
   if (wantsHelp(args2)) {
     console.log(`
 \x1B[1mopenacp reset\x1B[0m \u2014 Re-run setup wizard
@@ -1368,8 +1488,11 @@ start fresh with the setup wizard. The daemon must be stopped first.
 `);
     return;
   }
-  const { getStatus } = await import("./daemon-XFEMMJSZ.js");
-  const status = getStatus();
+  const os7 = await import("os");
+  const path10 = await import("path");
+  const root2 = instanceRoot ?? path10.join(os7.homedir(), ".openacp");
+  const { getStatus, getPidPath } = await import("./daemon-UOSRDEXW.js");
+  const status = getStatus(getPidPath(root2));
   if (status.running) {
     console.error("OpenACP is running. Stop it first: openacp stop");
     process.exit(1);
@@ -1385,11 +1508,8 @@ start fresh with the setup wizard. The daemon must be stopped first.
   }
   const { uninstallAutoStart } = await import("./autostart-CUPZMKKC.js");
   uninstallAutoStart();
-  const fs4 = await import("fs");
-  const os2 = await import("os");
-  const path5 = await import("path");
-  const openacpDir = path5.join(os2.homedir(), ".openacp");
-  fs4.rmSync(openacpDir, { recursive: true, force: true });
+  const fs5 = await import("fs");
+  fs5.rmSync(root2, { recursive: true, force: true });
   console.log("Reset complete. Run `openacp` to set up again.");
 }
 
@@ -1472,7 +1592,7 @@ as a messaging thread. Requires a running daemon.
     process.exit(1);
   }
   try {
-    const { apiCall: apiCall2 } = await import("./api-client-XTLRRFPX.js");
+    const { apiCall: apiCall2 } = await import("./api-client-PEMHYL5U.js");
     const res = await apiCall2(port, "/api/sessions/adopt", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -1600,7 +1720,7 @@ Fixable issues can be auto-repaired when not using --dry-run.
     process.exit(1);
   }
   const dryRun = args2.includes("--dry-run");
-  const { DoctorEngine } = await import("./doctor-AV6AUO22.js");
+  const { DoctorEngine } = await import("./doctor-6DLACBR4.js");
   const engine = new DoctorEngine({ dryRun });
   console.log("\n\u{1FA7A} OpenACP Doctor\n");
   const report = await engine.runAll();
@@ -1710,7 +1830,7 @@ Run 'openacp agents' to see available agents.`);
   }
 }
 async function agentsList() {
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   await catalog.refreshRegistryIfStale();
@@ -1773,7 +1893,7 @@ Run 'openacp agents' to see available agents.
 `);
     return;
   }
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   await catalog.refreshRegistryIfStale();
@@ -1852,7 +1972,7 @@ async function agentsUninstall(name, help = false) {
 `);
     return;
   }
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   const result = await catalog.uninstall(name);
@@ -1880,7 +2000,7 @@ async function agentsUninstall(name, help = false) {
   }
 }
 async function agentsRefresh() {
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   console.log("\n  Updating agent list...");
@@ -1907,7 +2027,7 @@ whether the agent is installed or available from the registry.
 `);
     return;
   }
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   const { getAgentSetup } = await import("./agent-dependencies-ED2ZTUHG.js");
@@ -1988,7 +2108,7 @@ ACP-specific flags are automatically stripped.
 `);
     return;
   }
-  const { AgentCatalog } = await import("./agent-catalog-SZQQERV7.js");
+  const { AgentCatalog } = await import("./agent-catalog-UYD26QDK.js");
   const catalog = new AgentCatalog();
   catalog.load();
   const installed = catalog.getInstalledAgent(nameOrId);
@@ -2121,30 +2241,35 @@ Tunnel Management:
 }
 
 // src/cli/commands/onboard.ts
+import * as path6 from "path";
 async function cmdOnboard() {
-  const { ConfigManager, PLUGINS_DATA_DIR: PLUGINS_DATA_DIR2, REGISTRY_PATH: REGISTRY_PATH2 } = await import("./config-KN6NKKPF.js");
+  const { ConfigManager } = await import("./config-X4UP7H6R.js");
   const { SettingsManager } = await import("./settings-manager-B4UN2LAC.js");
   const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
+  const { getGlobalRoot: getGlobalRoot2 } = await import("./instance-context-FLCE7VZ4.js");
+  const OPENACP_DIR = getGlobalRoot2();
+  const PLUGINS_DATA_DIR = path6.join(OPENACP_DIR, "plugins", "data");
+  const REGISTRY_PATH = path6.join(OPENACP_DIR, "plugins.json");
   const cm = new ConfigManager();
-  const settingsManager = new SettingsManager(PLUGINS_DATA_DIR2);
-  const pluginRegistry = new PluginRegistry(REGISTRY_PATH2);
+  const settingsManager = new SettingsManager(PLUGINS_DATA_DIR);
+  const pluginRegistry = new PluginRegistry(REGISTRY_PATH);
   await pluginRegistry.load();
   if (await cm.exists()) {
-    const { runReconfigure } = await import("./setup-DISPNDEK.js");
+    const { runReconfigure } = await import("./setup-44WLBIOT.js");
     await runReconfigure(cm);
   } else {
-    const { runSetup } = await import("./setup-DISPNDEK.js");
+    const { runSetup } = await import("./setup-44WLBIOT.js");
     await runSetup(cm, { skipRunMode: true, settingsManager, pluginRegistry });
   }
 }
 
 // src/cli/commands/default.ts
-import path3 from "path";
-import os from "os";
-var OPENACP_DIR = path3.join(os.homedir(), ".openacp");
-var PLUGINS_DATA_DIR = path3.join(OPENACP_DIR, "plugins", "data");
-var REGISTRY_PATH = path3.join(OPENACP_DIR, "plugins.json");
-async function cmdDefault(command2) {
+import path7 from "path";
+import os6 from "os";
+async function cmdDefault(command2, instanceRoot) {
+  const root2 = instanceRoot ?? path7.join(os6.homedir(), ".openacp");
+  const pluginsDataDir = path7.join(root2, "plugins", "data");
+  const registryPath = path7.join(root2, "plugins.json");
   const forceForeground = command2 === "--foreground";
   if (command2 && !command2.startsWith("-")) {
     const { suggestMatch } = await import("./suggest-RST5VOHB.js");
@@ -2174,23 +2299,23 @@ async function cmdDefault(command2) {
     process.exit(1);
   }
   await checkAndPromptUpdate();
-  const { ConfigManager } = await import("./config-KN6NKKPF.js");
+  const { ConfigManager } = await import("./config-X4UP7H6R.js");
   const cm = new ConfigManager();
   if (!await cm.exists()) {
     const { SettingsManager } = await import("./settings-manager-B4UN2LAC.js");
     const { PluginRegistry } = await import("./plugin-registry-6J3YSFHF.js");
-    const settingsManager = new SettingsManager(PLUGINS_DATA_DIR);
-    const pluginRegistry = new PluginRegistry(REGISTRY_PATH);
+    const settingsManager = new SettingsManager(pluginsDataDir);
+    const pluginRegistry = new PluginRegistry(registryPath);
     await pluginRegistry.load();
-    const { runSetup } = await import("./setup-DISPNDEK.js");
+    const { runSetup } = await import("./setup-44WLBIOT.js");
     const shouldStart = await runSetup(cm, { settingsManager, pluginRegistry });
     if (!shouldStart) process.exit(0);
   }
   await cm.load();
   const config = cm.get();
   if (!forceForeground && config.runMode === "daemon") {
-    const { startDaemon, getPidPath } = await import("./daemon-XFEMMJSZ.js");
-    const result = startDaemon(getPidPath(), config.logging.logDir);
+    const { startDaemon, getPidPath } = await import("./daemon-UOSRDEXW.js");
+    const result = startDaemon(getPidPath(root2), config.logging.logDir, root2);
     if ("error" in result) {
       console.error(result.error);
       process.exit(1);
@@ -2198,15 +2323,20 @@ async function cmdDefault(command2) {
     console.log(`OpenACP daemon started (PID ${result.pid})`);
     return;
   }
-  const { markRunning } = await import("./daemon-XFEMMJSZ.js");
-  markRunning();
-  const { startServer } = await import("./main-VEJCG5PY.js");
-  await startServer();
+  const { markRunning } = await import("./daemon-UOSRDEXW.js");
+  markRunning(root2);
+  const { startServer } = await import("./main-D7M2AKRM.js");
+  const ctx = createInstanceContext({
+    id: "default",
+    root: root2,
+    isGlobal: root2 === getGlobalRoot()
+  });
+  await startServer({ instanceContext: ctx });
 }
 
 // src/cli/commands/dev.ts
-import fs3 from "fs";
-import path4 from "path";
+import fs4 from "fs";
+import path8 from "path";
 async function cmdDev(args2 = []) {
   if (wantsHelp(args2)) {
     console.log(`
@@ -2233,13 +2363,13 @@ async function cmdDev(args2 = []) {
     console.error("Error: missing plugin path. Usage: openacp dev <plugin-path>");
     process.exit(1);
   }
-  const pluginPath = path4.resolve(pluginPathArg);
-  if (!fs3.existsSync(pluginPath)) {
+  const pluginPath = path8.resolve(pluginPathArg);
+  if (!fs4.existsSync(pluginPath)) {
     console.error(`Error: plugin path does not exist: ${pluginPath}`);
     process.exit(1);
   }
-  const tsconfigPath = path4.join(pluginPath, "tsconfig.json");
-  const hasTsconfig = fs3.existsSync(tsconfigPath);
+  const tsconfigPath = path8.join(pluginPath, "tsconfig.json");
+  const hasTsconfig = fs4.existsSync(tsconfigPath);
   if (hasTsconfig) {
     console.log("Compiling plugin TypeScript...");
     const { execSync: execSync3 } = await import("child_process");
@@ -2274,30 +2404,74 @@ async function cmdDev(args2 = []) {
     process.env.OPENACP_DEBUG = "1";
   }
   process.env.OPENACP_DEV_LOOP = "1";
-  const { startServer } = await import("./main-VEJCG5PY.js");
+  const { startServer } = await import("./main-D7M2AKRM.js");
   await startServer({ devPluginPath: pluginPath, noWatch });
 }
 
 // src/cli.ts
 setDefaultAutoSelectFamily(false);
-var args = process.argv.slice(2);
-var command = args[0];
+function extractInstanceFlags(args2) {
+  const flags2 = { local: false, global: false };
+  const remaining2 = [];
+  let i = 0;
+  while (i < args2.length) {
+    if (args2[i] === "--local") {
+      flags2.local = true;
+      i++;
+    } else if (args2[i] === "--global") {
+      flags2.global = true;
+      i++;
+    } else if (args2[i] === "--dir" && args2[i + 1]) {
+      flags2.dir = args2[i + 1];
+      i += 2;
+    } else if (args2[i] === "--from" && args2[i + 1]) {
+      flags2.from = args2[i + 1];
+      i += 2;
+    } else if (args2[i] === "--name" && args2[i + 1]) {
+      flags2.name = args2[i + 1];
+      i += 2;
+    } else {
+      remaining2.push(args2[i]);
+      i++;
+    }
+  }
+  return { flags: flags2, remaining: remaining2 };
+}
+var resolvedInstanceRoot = null;
+var instanceFlags = { local: false, global: false };
+function getResolvedInstanceRoot() {
+  return resolvedInstanceRoot;
+}
+function getInstanceFlags() {
+  return instanceFlags;
+}
+var allArgs = process.argv.slice(2);
+var { flags, remaining } = extractInstanceFlags(allArgs);
+instanceFlags = flags;
+var [command, ...args] = remaining;
+resolvedInstanceRoot = resolveInstanceRoot({
+  dir: flags.dir,
+  local: flags.local,
+  global: flags.global,
+  cwd: process.cwd()
+});
+var root = resolvedInstanceRoot ?? getGlobalRoot();
 var commands = {
   "--help": async () => printHelp(),
   "-h": async () => printHelp(),
   "--version": () => cmdVersion(),
   "-v": () => cmdVersion(),
-  "install": () => cmdInstall(args),
-  "uninstall": () => cmdUninstall(args),
-  "plugins": () => cmdPlugins(args),
-  "plugin": () => cmdPlugin(args),
+  "install": () => cmdInstall(args, root),
+  "uninstall": () => cmdUninstall(args, root),
+  "plugins": () => cmdPlugins(args, root),
+  "plugin": () => cmdPlugin(args, root),
   "api": () => cmdApi(args),
-  "start": () => cmdStart(args),
-  "stop": () => cmdStop(args),
+  "start": () => cmdStart(args, root),
+  "stop": () => cmdStop(args, root),
   "status": () => cmdStatus(args),
   "logs": () => cmdLogs(args),
   "config": () => cmdConfig(args),
-  "reset": () => cmdReset(args),
+  "reset": () => cmdReset(args, root),
   "update": () => cmdUpdate(args),
   "adopt": () => cmdAdopt(args),
   "integrate": () => cmdIntegrate(args),
@@ -2307,8 +2481,24 @@ var commands = {
   "onboard": () => cmdOnboard(),
   "dev": () => cmdDev(args),
   "--daemon-child": async () => {
-    const { startServer } = await import("./main-VEJCG5PY.js");
-    await startServer();
+    const { startServer } = await import("./main-D7M2AKRM.js");
+    const envRoot = process.env.OPENACP_INSTANCE_ROOT;
+    if (envRoot) {
+      const { createInstanceContext: createInstanceContext2, getGlobalRoot: getGlobal } = await import("./instance-context-FLCE7VZ4.js");
+      const { InstanceRegistry: InstanceRegistry2 } = await import("./instance-registry-SW5FWKHO.js");
+      const registry = new InstanceRegistry2(path9.join(getGlobal(), "instances.json"));
+      await registry.load();
+      const entry = registry.getByRoot(envRoot);
+      const id = entry?.id ?? "unknown";
+      const ctx = createInstanceContext2({
+        id,
+        root: envRoot,
+        isGlobal: envRoot === getGlobal()
+      });
+      await startServer({ instanceContext: ctx });
+    } else {
+      await startServer();
+    }
   }
 };
 async function main() {
@@ -2316,11 +2506,15 @@ async function main() {
   if (handler) {
     await handler();
   } else {
-    await cmdDefault(command);
+    await cmdDefault(command, root);
   }
 }
 main().catch((err) => {
   console.error("Fatal:", err);
   process.exit(1);
 });
+export {
+  getInstanceFlags,
+  getResolvedInstanceRoot
+};
 //# sourceMappingURL=cli.js.map