@wuyax/mcps 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/cli.cjs

@@ -23,11 +23,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli.ts
-var import_commander4 = require("commander");
+var import_commander5 = require("commander");
 
 // src/cli/add.ts
-var import_commander = require("commander");
-var import_picocolors11 = __toESM(require("picocolors"), 1);
+var import_commander2 = require("commander");
+var import_picocolors17 = __toESM(require("picocolors"), 1);
 
 // src/agents.ts
 var import_node_fs = require("fs");
@@ -483,9 +483,9 @@ var mcpAgentAliases = {
 var getMcpAgentConfig = (agentType) => mcpAgents[agentType];
 var getMcpAgentTypes = () => Object.values(mcpAgents).map((config) => config.name);
 var isMcpAgentType = (value) => value in mcpAgents;
-var resolveMcpAgentAlias = (input5) => {
-  if (isMcpAgentType(input5)) return input5;
-  return mcpAgentAliases[input5] ?? null;
+var resolveMcpAgentAlias = (input7) => {
+  if (isMcpAgentType(input7)) return input7;
+  return mcpAgentAliases[input7] ?? null;
 };
 var isMcpTransportSupported = (agent, transport) => agent.supportedTransports.includes(transport);
 var detectProjectInstalledMcpAgents = (cwd) => getMcpAgentTypes().filter(
@@ -577,8 +577,6 @@ var buildMcpServerConfig = (parsed, options = {}) => {
 };
 
 // src/parse-server-config.ts
-var isRemoteServerConfig = (config) => typeof config.url === "string" && config.url.length > 0;
-var isStdioServerConfig = (config) => typeof config.command === "string" && config.command.length > 0;
 var parseServerConfig = (raw) => {
   if (!raw || typeof raw !== "object") return {};
   const data = raw;
@@ -996,6 +994,74 @@ var agentConfigStore = new AgentConfigStore();
 // src/utils/to-error-message.ts
 var toErrorMessage = (error, fallback = "Unknown error") => error instanceof Error ? error.message : fallback;
 
+// src/resolve-config-clusters.ts
+var getCandidateAgentsForScope = (options = {}) => {
+  return options.global ? getMcpAgentTypes() : getMcpAgentsSupportingProjectScope();
+};
+var getCoHostedAgents = (agentType, options = {}) => {
+  const currentAgent = getMcpAgentConfig(agentType);
+  const currentTarget = resolveMcpConfigTarget(currentAgent, options);
+  const candidates = getCandidateAgentsForScope(options);
+  const coHosted = [];
+  for (const candidateType of candidates) {
+    if (candidateType === agentType) continue;
+    const candidateConfig = getMcpAgentConfig(candidateType);
+    const candidateTarget = resolveMcpConfigTarget(candidateConfig, options);
+    if (candidateTarget.configPath === currentTarget.configPath && candidateTarget.configKey === currentTarget.configKey) {
+      coHosted.push(candidateType);
+    }
+  }
+  return coHosted;
+};
+var resolveConfigClusters = (agentTypes, options = {}) => {
+  const clustersByPath = /* @__PURE__ */ new Map();
+  for (const agentType of agentTypes) {
+    const agentConfig = getMcpAgentConfig(agentType);
+    const target = resolveMcpConfigTarget(agentConfig, options);
+    let keyMap = clustersByPath.get(target.configPath);
+    if (!keyMap) {
+      keyMap = /* @__PURE__ */ new Map();
+      clustersByPath.set(target.configPath, keyMap);
+    }
+    let cluster = keyMap.get(target.configKey);
+    if (!cluster) {
+      const allCoHosted = getCoHostedAgents(agentType, options);
+      cluster = {
+        configPath: target.configPath,
+        configKey: target.configKey,
+        targetAgents: [],
+        coHostedAgents: allCoHosted
+      };
+      keyMap.set(target.configKey, cluster);
+    }
+    if (!cluster.targetAgents.includes(agentType)) {
+      cluster.targetAgents.push(agentType);
+    }
+  }
+  const clusters = [];
+  for (const keyMap of clustersByPath.values()) {
+    for (const cluster of keyMap.values()) {
+      cluster.coHostedAgents = cluster.coHostedAgents.filter(
+        (co) => !cluster.targetAgents.includes(co)
+      );
+      clusters.push(cluster);
+    }
+  }
+  return clusters;
+};
+var sortAgentsWithClusters = (agentTypes, options = {}) => {
+  const clusters = resolveConfigClusters(agentTypes, options);
+  const sorted = [];
+  for (const cluster of clusters) {
+    for (const agent of cluster.targetAgents) {
+      if (!sorted.includes(agent)) {
+        sorted.push(agent);
+      }
+    }
+  }
+  return sorted;
+};
+
 // src/transforms/index.ts
 var DIALECT_PRESETS = {
   vscode: {
@@ -1204,32 +1270,69 @@ var transformServerConfigForAgent = (agent, serverName, config, context = { glob
 };
 
 // src/installer.ts
-var installMcpServerForAgent = (serverName, serverConfig, agentType, options = {}) => {
-  const agent = getMcpAgentConfig(agentType);
+var installMcpServerForAgents = (serverName, serverConfig, agentTypes, options = {}) => {
+  const clusters = resolveConfigClusters(agentTypes, options);
+  const resultsByAgent = /* @__PURE__ */ new Map();
   const isGlobal = options.global ?? false;
-  const { target } = agentConfigStore.resolveTarget(agent, options);
-  try {
-    const transformed = transformServerConfigForAgent(agent, serverName, serverConfig, {
-      global: isGlobal
-    });
-    agentConfigStore.writeServer(agent, serverName, transformed, options);
-    return { agent: agentType, success: true, path: target.configPath };
-  } catch (error) {
-    return {
-      agent: agentType,
-      success: false,
-      path: target.configPath,
-      error: toErrorMessage(error)
-    };
+  for (const cluster of clusters) {
+    const primaryAgentType = cluster.targetAgents[0];
+    const primaryAgent = getMcpAgentConfig(primaryAgentType);
+    try {
+      const transformed = transformServerConfigForAgent(primaryAgent, serverName, serverConfig, {
+        global: isGlobal
+      });
+      agentConfigStore.writeServer(primaryAgent, serverName, transformed, options);
+      for (const agentType of cluster.targetAgents) {
+        resultsByAgent.set(agentType, {
+          agent: agentType,
+          success: true,
+          path: cluster.configPath,
+          coConfiguredAgents: cluster.coHostedAgents.length > 0 ? cluster.coHostedAgents : void 0
+        });
+      }
+    } catch (error) {
+      const errorMsg = toErrorMessage(error);
+      for (const agentType of cluster.targetAgents) {
+        resultsByAgent.set(agentType, {
+          agent: agentType,
+          success: false,
+          path: cluster.configPath,
+          error: errorMsg
+        });
+      }
+    }
   }
+  return agentTypes.map((agentType) => resultsByAgent.get(agentType));
+};
+var installToCompatibleAgents = (serverName, serverConfig, options) => {
+  const { allAgents, incompatible = [], global: isGlobal, cwd } = options;
+  const incompatibleMap = new Map(incompatible.map((item) => [item.agent, item.reason]));
+  const compatibleAgents = allAgents.filter((a) => !incompatibleMap.has(a));
+  const installedResults = installMcpServerForAgents(serverName, serverConfig, compatibleAgents, {
+    global: isGlobal,
+    cwd
+  });
+  const installedMap = new Map(installedResults.map((r) => [r.agent, r]));
+  return allAgents.map((agentType) => {
+    const incompatibleReason = incompatibleMap.get(agentType);
+    if (incompatibleReason) {
+      return {
+        agent: agentType,
+        success: false,
+        path: "",
+        error: incompatibleReason
+      };
+    }
+    return installedMap.get(agentType);
+  });
 };
 
 // src/utils/parse-mcp-agent-list.ts
-var parseMcpAgentList = (input5) => {
-  if (!input5 || input5.length === 0) return void 0;
-  if (input5.includes("*")) return getMcpAgentTypes();
+var parseMcpAgentList = (input7) => {
+  if (!input7 || input7.length === 0) return void 0;
+  if (input7.includes("*")) return getMcpAgentTypes();
   const resolved = [];
-  for (const value of input5) {
+  for (const value of input7) {
     const agentType = resolveMcpAgentAlias(value);
     if (!agentType) throw new Error(`Unknown MCP agent "${value}"`);
     resolved.push(agentType);
@@ -1238,9 +1341,9 @@ var parseMcpAgentList = (input5) => {
 };
 
 // src/resolve-target-agents.ts
-var normalizeRequestedAgents = (input5) => {
-  if (!input5 || input5.length === 0) return void 0;
-  const rawList = [...input5];
+var normalizeRequestedAgents = (input7) => {
+  if (!input7 || input7.length === 0) return void 0;
+  const rawList = [...input7];
   if (rawList.every((item) => isMcpAgentType(item))) {
     return rawList;
   }
@@ -1300,29 +1403,29 @@ var REMOTE_URL_REGEX = /^https?:\/\//i;
 var HAS_WHITESPACE_REGEX = /\s/;
 var PACKAGE_NAME_REGEX = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*(?:@[^\s]+)?$/;
 var PATH_SEPARATOR_REGEX = /[/\\]/;
-var stripVersionSuffix = (input5) => {
-  if (input5.startsWith("@")) {
-    const secondAtIndex = input5.indexOf("@", 1);
-    if (secondAtIndex > 0) return input5.slice(0, secondAtIndex);
-    return input5;
-  }
-  const atIndex = input5.lastIndexOf("@");
-  if (atIndex > 0) return input5.slice(0, atIndex);
-  return input5;
-};
-var stripScopePrefix = (input5) => {
-  if (!input5.startsWith("@") || !input5.includes("/")) return input5;
-  const parts = input5.split("/");
-  return parts[1] || input5;
-};
-var stripPathPrefix = (input5) => {
-  if (!PATH_SEPARATOR_REGEX.test(input5)) return input5;
-  const segments = input5.split(PATH_SEPARATOR_REGEX);
+var stripVersionSuffix = (input7) => {
+  if (input7.startsWith("@")) {
+    const secondAtIndex = input7.indexOf("@", 1);
+    if (secondAtIndex > 0) return input7.slice(0, secondAtIndex);
+    return input7;
+  }
+  const atIndex = input7.lastIndexOf("@");
+  if (atIndex > 0) return input7.slice(0, atIndex);
+  return input7;
+};
+var stripScopePrefix = (input7) => {
+  if (!input7.startsWith("@") || !input7.includes("/")) return input7;
+  const parts = input7.split("/");
+  return parts[1] || input7;
+};
+var stripPathPrefix = (input7) => {
+  if (!PATH_SEPARATOR_REGEX.test(input7)) return input7;
+  const segments = input7.split(PATH_SEPARATOR_REGEX);
   const basename = segments[segments.length - 1];
-  return basename || input5;
+  return basename || input7;
 };
-var extractPackageName = (input5) => {
-  let name = stripVersionSuffix(input5);
+var extractPackageName = (input7) => {
+  let name = stripVersionSuffix(input7);
   name = stripScopePrefix(name);
   name = stripPathPrefix(name);
   name = name.replace(SCRIPT_EXTENSION_REGEX, "");
@@ -1340,9 +1443,9 @@ var extractPackageName = (input5) => {
   }
   return name || MCP_DEFAULT_SERVER_NAME;
 };
-var inferNameFromUrl = (input5) => {
+var inferNameFromUrl = (input7) => {
   try {
-    const url = new URL(input5);
+    const url = new URL(input7);
     const host = url.hostname;
     const labels = host.split(".").filter((segment) => segment.length > 0);
     if (labels.length === 0) return MCP_DEFAULT_SERVER_NAME;
@@ -1371,8 +1474,8 @@ var inferNameFromCommand = (command) => {
   const firstNonFlag = tokens.find((token) => !token.startsWith("-"));
   return firstNonFlag ? extractPackageName(firstNonFlag) : MCP_DEFAULT_SERVER_NAME;
 };
-var parseMcpSource = (input5) => {
-  const trimmed = input5.trim();
+var parseMcpSource = (input7) => {
+  const trimmed = input7.trim();
   if (trimmed.length === 0) {
     throw new Error(
       "Invalid MCP source: input is empty. Expected a remote URL, an npm package, or a command line."
@@ -1425,18 +1528,11 @@ var installMcpServer = (options) => {
     cwd,
     transport: requestedTransport
   });
-  const incompatibleMap = new Map(incompatible.map((item) => [item.agent, item.reason]));
-  const results = allAgents.map((agentType) => {
-    const incompatibleReason = incompatibleMap.get(agentType);
-    if (incompatibleReason) {
-      return {
-        agent: agentType,
-        success: false,
-        path: "",
-        error: incompatibleReason
-      };
-    }
-    return installMcpServerForAgent(serverName, serverConfig, agentType, { global: isGlobal, cwd });
+  const results = installToCompatibleAgents(serverName, serverConfig, {
+    allAgents,
+    incompatible,
+    global: isGlobal,
+    cwd
   });
   return { serverName, config: serverConfig, results };
 };
@@ -1463,21 +1559,6 @@ var listInstalledMcpServers = (options = {}) => {
 };
 
 // src/remove.ts
-var removeMcpServerFromAgent = (serverName, agentType, options = {}) => {
-  const agent = getMcpAgentConfig(agentType);
-  const { target } = agentConfigStore.resolveTarget(agent, options);
-  try {
-    const { removed } = agentConfigStore.removeServer(agent, serverName, options);
-    return { agent: agentType, path: target.configPath, removed };
-  } catch (error) {
-    return {
-      agent: agentType,
-      path: target.configPath,
-      removed: false,
-      error: toErrorMessage(error)
-    };
-  }
-};
 var removeMcpServer = (options) => {
   const { allAgents } = resolveTargetAgents({
     requested: options.agents,
@@ -1485,24 +1566,153 @@ var removeMcpServer = (options) => {
     global: options.global,
     cwd: options.cwd
   });
+  const clusters = resolveConfigClusters(allAgents, {
+    global: options.global,
+    cwd: options.cwd
+  });
   const results = [];
-  for (const agentType of allAgents) {
-    const result = removeMcpServerFromAgent(options.name, agentType, {
-      global: options.global,
-      cwd: options.cwd
-    });
-    if (result.removed || result.error) results.push(result);
+  for (const cluster of clusters) {
+    const primaryAgentType = cluster.targetAgents[0];
+    const primaryAgent = getMcpAgentConfig(primaryAgentType);
+    try {
+      const { removed } = agentConfigStore.removeServer(primaryAgent, options.name, {
+        global: options.global,
+        cwd: options.cwd
+      });
+      if (removed) {
+        for (const agentType of cluster.targetAgents) {
+          results.push({
+            agent: agentType,
+            path: cluster.configPath,
+            removed: true,
+            coAffectedAgents: cluster.coHostedAgents.length > 0 ? cluster.coHostedAgents : void 0
+          });
+        }
+      }
+    } catch (error) {
+      const errorMsg = toErrorMessage(error);
+      for (const agentType of cluster.targetAgents) {
+        results.push({
+          agent: agentType,
+          path: cluster.configPath,
+          removed: false,
+          error: errorMsg
+        });
+      }
+    }
   }
   return results;
 };
 
+// src/update-mcp-server.ts
+var toRemoteServerConfig = (config, defaultTransport = "http") => {
+  const {
+    command: _droppedCommand,
+    args: _droppedArgs,
+    env: _droppedEnv,
+    ...remoteConfig
+  } = config;
+  return {
+    ...remoteConfig,
+    type: remoteConfig.type ?? defaultTransport
+  };
+};
+var toStdioServerConfig = (config) => {
+  const {
+    url: _droppedUrl,
+    type: _droppedType,
+    headers: _droppedHeaders,
+    ...stdioConfig
+  } = config;
+  return stdioConfig;
+};
+var detectUpdateTransition = (incoming, previous) => {
+  if (!previous) {
+    return incoming.url ? "switch-to-remote" : "switch-to-stdio";
+  }
+  if (incoming.url && !incoming.command) {
+    return "switch-to-remote";
+  }
+  if (incoming.command && !incoming.url) {
+    return "switch-to-stdio";
+  }
+  if (incoming.url || !incoming.command && previous.url) {
+    return "merge-remote";
+  }
+  return "merge-stdio";
+};
+var sanitizeUpdatedServerConfig = (incoming, previous) => {
+  const transition = detectUpdateTransition(incoming, previous);
+  const targetTransport = incoming.type ?? previous?.type ?? "http";
+  switch (transition) {
+    case "switch-to-remote": {
+      const cleanBase = previous ? toRemoteServerConfig(previous, targetTransport) : {};
+      return toRemoteServerConfig({ ...cleanBase, ...incoming }, targetTransport);
+    }
+    case "switch-to-stdio": {
+      const cleanBase = previous ? toStdioServerConfig(previous) : {};
+      return toStdioServerConfig({ ...cleanBase, ...incoming });
+    }
+    case "merge-remote": {
+      return toRemoteServerConfig({ ...previous, ...incoming }, targetTransport);
+    }
+    case "merge-stdio": {
+      return toStdioServerConfig({ ...previous, ...incoming });
+    }
+  }
+};
+var updateMcpServer = (options) => {
+  const isGlobal = options.global ?? false;
+  const cwd = options.cwd ?? process.cwd();
+  let previousConfig = options.previousConfig;
+  if (!previousConfig) {
+    const existing = listInstalledMcpServers({
+      global: isGlobal,
+      cwd,
+      agents: options.agents
+    });
+    const found = existing.find((s) => s.serverName === options.serverName && s.serverConfig);
+    if (found) {
+      previousConfig = found.serverConfig;
+    }
+  }
+  const serverConfig = sanitizeUpdatedServerConfig(options.config, previousConfig);
+  let targetAgents = options.agents;
+  if (!targetAgents || targetAgents.length === 0) {
+    const existing = listInstalledMcpServers({ global: isGlobal, cwd });
+    targetAgents = existing.filter((s) => s.serverName === options.serverName).map((s) => s.agent);
+  }
+  const requestedTransport = serverConfig.url ? serverConfig.type ?? "http" : "stdio";
+  const { allAgents, incompatible } = resolveTargetAgents({
+    requested: targetAgents,
+    global: isGlobal,
+    cwd,
+    transport: requestedTransport
+  });
+  const results = installToCompatibleAgents(options.serverName, serverConfig, {
+    allAgents,
+    incompatible,
+    global: isGlobal,
+    cwd
+  });
+  return {
+    serverName: options.serverName,
+    config: serverConfig,
+    results,
+    incompatible
+  };
+};
+
 // src/interactive/main-menu.ts
 var import_prompts10 = require("@inquirer/prompts");
-var import_picocolors10 = __toESM(require("picocolors"), 1);
+var import_picocolors15 = __toESM(require("picocolors"), 1);
 
 // src/interactive/wizard-add.ts
 var import_prompts7 = require("@inquirer/prompts");
-var import_picocolors7 = __toESM(require("picocolors"), 1);
+var import_picocolors11 = __toESM(require("picocolors"), 1);
+
+// src/utils/co-hosted-feedback.ts
+var import_picocolors2 = __toESM(require("picocolors"), 1);
 
 // src/utils/logger.ts
 var import_picocolors = __toESM(require("picocolors"), 1);
@@ -1521,13 +1731,269 @@ var logger = {
   }
 };
 
+// src/utils/co-hosted-feedback.ts
+var formatCoHostedBadge = (kind, agents) => {
+  if (!agents || agents.length === 0) return "";
+  const label = kind === "configured" ? "co-configured" : "co-affected";
+  return ` ${import_picocolors2.default.yellow(`(${label}: ${agents.join(", ")})`)}`;
+};
+var logCoHostedNotice = (kind, agents) => {
+  if (!agents || agents.length === 0) return;
+  const actionText = kind === "configured" ? "Also configured for" : "Also affects";
+  logger.info(
+    `  ${import_picocolors2.default.dim("Note:")} ${actionText} co-hosted agent(s): ${import_picocolors2.default.yellow(agents.join(", "))}`
+  );
+};
+
 // src/interactive/prompts/agents.ts
-var import_prompts2 = require("@inquirer/prompts");
+var import_picocolors6 = __toESM(require("picocolors"), 1);
+
+// src/interactive/utils/build-linked-agent-choices.ts
 var import_picocolors3 = __toESM(require("picocolors"), 1);
+var buildLinkedAgentChoices = (options) => {
+  const { agents, checkedAgents, detectedAgents = [], scopeOptions = {} } = options;
+  const alignedCheckedSet = new Set(checkedAgents);
+  for (const agent of checkedAgents) {
+    const coHosted = getCoHostedAgents(agent, scopeOptions);
+    for (const co of coHosted) {
+      if (agents.includes(co)) {
+        alignedCheckedSet.add(co);
+      }
+    }
+  }
+  return agents.map((agent) => {
+    const config = getMcpAgentConfig(agent);
+    const displayName = config?.displayName ?? agent;
+    const isDetected = detectedAgents.includes(agent);
+    const coHosted = getCoHostedAgents(agent, scopeOptions).filter(
+      (co) => agents.includes(co)
+    );
+    const detectedBadge = isDetected ? import_picocolors3.default.green(" [detected]") : "";
+    const sharedBadge = coHosted.length > 0 ? import_picocolors3.default.dim(` [shared: ${coHosted.join(", ")}]`) : "";
+    const label = `${displayName} ${import_picocolors3.default.dim(`(${agent})`)}${detectedBadge}${sharedBadge}`;
+    return {
+      name: label,
+      value: agent,
+      checked: alignedCheckedSet.has(agent),
+      linkedValues: coHosted,
+      description: coHosted.length > 0 ? `Linked with ${coHosted.map((a) => getMcpAgentConfig(a).displayName).join(", ")} (shared configuration)` : void 0
+    };
+  });
+};
+
+// src/interactive/prompts/linked-checkbox.ts
+var import_core = require("@inquirer/core");
+var import_picocolors4 = __toESM(require("picocolors"), 1);
+var defaultTheme = {
+  icon: {
+    checked: import_picocolors4.default.green("[x]"),
+    unchecked: import_picocolors4.default.dim("[ ]"),
+    cursor: import_picocolors4.default.cyan(">"),
+    disabledChecked: import_picocolors4.default.dim("[x]"),
+    disabledUnchecked: import_picocolors4.default.dim("[-]")
+  },
+  style: {
+    disabled: (text) => import_picocolors4.default.dim(text),
+    renderSelectedChoices: (selectedChoices) => selectedChoices.map((choice) => choice.short).join(", "),
+    description: (text) => import_picocolors4.default.cyan(text),
+    keysHelpTip: (keys) => keys.map(([key, action]) => `${import_picocolors4.default.bold(key)} ${import_picocolors4.default.dim(action)}`).join(import_picocolors4.default.dim(" | ")),
+    highlight: (text) => import_picocolors4.default.cyan(text)
+  },
+  i18n: {
+    disabledError: "This option is disabled and cannot be toggled."
+  }
+};
+function isSelectable(item) {
+  return !import_core.Separator.isSeparator(item) && !item.disabled;
+}
+function isNavigable(item) {
+  return !import_core.Separator.isSeparator(item);
+}
+function isChecked(item) {
+  return !import_core.Separator.isSeparator(item) && item.checked;
+}
+function normalizeChoices(choices) {
+  return choices.map((choice) => {
+    if (import_core.Separator.isSeparator(choice)) {
+      return choice;
+    }
+    if (typeof choice !== "object" || choice === null || !("value" in choice)) {
+      const name2 = String(choice);
+      return {
+        value: choice,
+        name: name2,
+        short: name2,
+        checkedName: name2,
+        disabled: false,
+        checked: false,
+        linkedValues: []
+      };
+    }
+    const name = choice.name ?? String(choice.value);
+    return {
+      value: choice.value,
+      name,
+      short: choice.short ?? name,
+      checkedName: choice.checkedName ?? name,
+      description: choice.description,
+      disabled: choice.disabled ?? false,
+      checked: choice.checked ?? false,
+      linkedValues: choice.linkedValues ?? []
+    };
+  });
+}
+var linkedCheckbox = (0, import_core.createPrompt)(
+  (config, done) => {
+    const { pageSize = 10, loop = true, required, validate = () => true } = config;
+    const theme = (0, import_core.makeTheme)(defaultTheme, config.theme);
+    const [status, setStatus] = (0, import_core.useState)("idle");
+    const prefix = (0, import_core.usePrefix)({ status, theme });
+    const [items, setItems] = (0, import_core.useState)(() => normalizeChoices(config.choices));
+    const bounds = (0, import_core.useMemo)(() => {
+      const first = items.findIndex(isNavigable);
+      let last = -1;
+      for (let i = items.length - 1; i >= 0; i--) {
+        if (isNavigable(items[i])) {
+          last = i;
+          break;
+        }
+      }
+      if (first === -1 || last === -1) {
+        throw new import_core.ValidationError("[linkedCheckbox prompt] No selectable choices.");
+      }
+      return { first, last };
+    }, [items]);
+    const [active, setActive] = (0, import_core.useState)(bounds.first);
+    const [errorMsg, setError] = (0, import_core.useState)();
+    const toggleWithLinked = (targetIndex) => {
+      const targetItem = items[targetIndex];
+      if (!targetItem || import_core.Separator.isSeparator(targetItem) || targetItem.disabled) {
+        return;
+      }
+      const nextChecked = !targetItem.checked;
+      const targetValue = targetItem.value;
+      const linked = new Set(targetItem.linkedValues);
+      setItems(
+        (prevItems) => prevItems.map((item) => {
+          if (import_core.Separator.isSeparator(item) || item.disabled) {
+            return item;
+          }
+          const isTargetOrLinked = item.value === targetValue || linked.has(item.value) || item.linkedValues.includes(targetValue);
+          if (isTargetOrLinked) {
+            return { ...item, checked: nextChecked };
+          }
+          return item;
+        })
+      );
+    };
+    (0, import_core.useKeypress)(async (key) => {
+      if ((0, import_core.isEnterKey)(key)) {
+        const selection = items.filter(isChecked);
+        const isValid = await validate([...selection]);
+        if (required && selection.length === 0) {
+          setError("At least one choice must be selected");
+        } else if (isValid === true) {
+          setStatus("done");
+          done(selection.map((choice) => choice.value));
+        } else {
+          setError(typeof isValid === "string" ? isValid : "You must select a valid value");
+        }
+      } else if ((0, import_core.isUpKey)(key) || (0, import_core.isDownKey)(key)) {
+        if (errorMsg) setError(void 0);
+        if (loop || (0, import_core.isUpKey)(key) && active !== bounds.first || (0, import_core.isDownKey)(key) && active !== bounds.last) {
+          const offset = (0, import_core.isUpKey)(key) ? -1 : 1;
+          let next = active;
+          do {
+            next = (next + offset + items.length) % items.length;
+          } while (!isNavigable(items[next]));
+          setActive(next);
+        }
+      } else if ((0, import_core.isSpaceKey)(key)) {
+        const activeItem = items[active];
+        if (activeItem && !import_core.Separator.isSeparator(activeItem)) {
+          if (activeItem.disabled) {
+            setError(theme.i18n.disabledError);
+          } else {
+            setError(void 0);
+            toggleWithLinked(active);
+          }
+        }
+      } else if (key.name === "a") {
+        const hasUnchecked = items.some((choice) => isSelectable(choice) && !choice.checked);
+        setItems(
+          (prevItems) => prevItems.map((item) => isSelectable(item) ? { ...item, checked: hasUnchecked } : item)
+        );
+      } else if ((0, import_core.isNumberKey)(key)) {
+        const selectedIndex = Number(key.name) - 1;
+        let selectableIndex = -1;
+        const position = items.findIndex((item) => {
+          if (import_core.Separator.isSeparator(item)) return false;
+          selectableIndex++;
+          return selectableIndex === selectedIndex;
+        });
+        const selectedItem = items[position];
+        if (selectedItem && isSelectable(selectedItem)) {
+          setActive(position);
+          setError(void 0);
+          toggleWithLinked(position);
+        }
+      }
+    });
+    const message = theme.style.message(config.message, status);
+    let description;
+    const page = (0, import_core.usePagination)({
+      items,
+      active,
+      renderItem({ item, isActive }) {
+        if (import_core.Separator.isSeparator(item)) {
+          return ` ${item.separator}`;
+        }
+        const cursor = isActive ? theme.icon.cursor : " ";
+        if (item.disabled) {
+          const disabledLabel = typeof item.disabled === "string" ? item.disabled : "(disabled)";
+          const checkbox2 = item.checked ? theme.icon.disabledChecked : theme.icon.disabledUnchecked;
+          return theme.style.disabled(`${cursor} ${checkbox2} ${item.name} ${disabledLabel}`);
+        }
+        if (isActive) {
+          description = item.description;
+        }
+        const checkbox = item.checked ? theme.icon.checked : theme.icon.unchecked;
+        const name = item.checked ? item.checkedName : item.name;
+        const color = isActive ? theme.style.highlight : (x) => x;
+        return color(`${cursor} ${checkbox} ${name}`);
+      },
+      pageSize,
+      loop
+    });
+    if (status === "done") {
+      const selection = items.filter(isChecked);
+      const answer = theme.style.answer(theme.style.renderSelectedChoices(selection, items));
+      return [prefix, message, answer].filter(Boolean).join(" ");
+    }
+    const helpLine = theme.style.keysHelpTip([
+      ["up/down", "navigate"],
+      ["space", "toggle"],
+      ["a", "all"],
+      ["enter", "submit"]
+    ]);
+    const lines = [
+      [prefix, message].filter(Boolean).join(" "),
+      page,
+      helpLine
+    ];
+    if (description) {
+      lines.push(theme.style.description(description));
+    }
+    if (errorMsg) {
+      lines.push(theme.style.error(errorMsg));
+    }
+    return lines.join("\n");
+  }
+);
 
 // src/interactive/prompts/scope.ts
 var import_prompts = require("@inquirer/prompts");
-var import_picocolors2 = __toESM(require("picocolors"), 1);
+var import_picocolors5 = __toESM(require("picocolors"), 1);
 var promptScope = async (options = {}) => {
   const initialGlobal = options.defaultGlobal ?? options.global;
   if (initialGlobal !== void 0) {
@@ -1538,11 +2004,11 @@ var promptScope = async (options = {}) => {
     message: options.message ?? "Select MCP scope:",
     choices: [
       {
-        name: `Current Project - ${import_picocolors2.default.dim(cwd)}`,
+        name: `Current Project - ${import_picocolors5.default.dim(cwd)}`,
         value: false
       },
       {
-        name: `Global User Config - ${import_picocolors2.default.dim("applies across all projects")}`,
+        name: `Global User Config - ${import_picocolors5.default.dim("applies across all projects")}`,
         value: true
       }
     ]
@@ -1562,26 +2028,23 @@ var promptScopeAndAgents = async (options = {}) => {
     cwd
   });
   const detected = resolution.detected;
-  const availableAgentTypes = isGlobal ? getMcpAgentTypes() : getMcpAgentsSupportingProjectScope();
+  const rawAvailable = isGlobal ? getMcpAgentTypes() : getMcpAgentsSupportingProjectScope();
+  const availableAgentTypes = sortAgentsWithClusters(rawAvailable, { global: isGlobal, cwd });
   if (detected.length > 0) {
     logger.info(
-      `Detected configured agents: ${import_picocolors3.default.cyan(detected.map((a) => getMcpAgentConfig(a).displayName).join(", "))}`
+      `Detected configured agents: ${import_picocolors6.default.cyan(detected.map((a) => getMcpAgentConfig(a).displayName).join(", "))}`
     );
   } else {
     logger.warn(`No active ${isGlobal ? "global" : "project"} agents detected`);
   }
   const defaultChecked = options.defaultAgents && options.defaultAgents.length > 0 ? options.defaultAgents : detected;
-  const choices = availableAgentTypes.map((agentType) => {
-    const config = getMcpAgentConfig(agentType);
-    const isDetected = detected.includes(agentType);
-    const label = `${config.displayName} ${import_picocolors3.default.dim(`(${agentType})`)}${isDetected ? import_picocolors3.default.green(" [detected]") : ""}`;
-    return {
-      name: label,
-      value: agentType,
-      checked: defaultChecked.includes(agentType)
-    };
+  const choices = buildLinkedAgentChoices({
+    agents: availableAgentTypes,
+    checkedAgents: defaultChecked,
+    detectedAgents: detected,
+    scopeOptions: { global: isGlobal, cwd }
   });
-  const selectedAgents = await (0, import_prompts2.checkbox)({
+  const selectedAgents = await linkedCheckbox({
     message: "Select target agents (Space to select, Enter to confirm):",
     choices,
     validate: (chosen) => {
@@ -1598,7 +2061,7 @@ var promptScopeAndAgents = async (options = {}) => {
 };
 
 // src/interactive/prompts/args.ts
-var import_prompts3 = require("@inquirer/prompts");
+var import_prompts2 = require("@inquirer/prompts");
 var parseArgsString = (rawText) => {
   const matches = rawText.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g);
   if (!matches) return [];
@@ -1613,32 +2076,67 @@ var promptArgsConfig = async (initialArgs = []) => {
   if (initialArgs.length > 0) {
     return initialArgs;
   }
-  const needArgs = await (0, import_prompts3.confirm)({
+  const needArgs = await (0, import_prompts2.confirm)({
     message: "Configure command arguments (e.g. file paths, connection strings)?",
     default: false
   });
   if (!needArgs) {
     return [];
   }
-  const raw = await (0, import_prompts3.input)({
+  const raw = await (0, import_prompts2.input)({
     message: "Enter command arguments (space-separated, wrap paths with spaces in quotes):",
     validate: (val) => val.trim() ? true : "Arguments cannot be empty"
   });
   return parseArgsString(raw.trim());
 };
+var formatArgsString = (args) => {
+  return args.map((arg) => arg.includes(" ") || arg.includes('"') ? `"${arg.replace(/"/g, '\\"')}"` : arg).join(" ");
+};
+var promptEditArgs = async (currentArgs = []) => {
+  const defaultStr = formatArgsString(currentArgs);
+  const raw = await (0, import_prompts2.input)({
+    message: "Edit command arguments (space-separated, wrap paths with spaces in quotes, leave empty to clear):",
+    default: defaultStr
+  });
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    return [];
+  }
+  return parseArgsString(trimmed);
+};
 
 // src/interactive/prompts/env.ts
 var import_prompts5 = require("@inquirer/prompts");
-var import_picocolors5 = __toESM(require("picocolors"), 1);
+var import_picocolors9 = __toESM(require("picocolors"), 1);
+
+// src/utils/mask-secret.ts
+var SECRET_KEY_PATTERN = /(token|key|secret|password|passwd|auth|credential)/i;
+var maskSecretValue = (key, value) => {
+  if (!SECRET_KEY_PATTERN.test(key) || value.length <= 4) {
+    return value;
+  }
+  return `${value.slice(0, 2)}***${value.slice(-2)}`;
+};
+var SECRET_HEADER_PATTERN = /(authorization|token|key|secret|auth)/i;
+var maskSecretHeader = (key, value) => {
+  if (!SECRET_HEADER_PATTERN.test(key) || value.length <= 8) {
+    return value;
+  }
+  return `${value.slice(0, 4)}***${value.slice(-3)}`;
+};
+
+// src/interactive/prompts/kv.ts
+var import_prompts4 = require("@inquirer/prompts");
+var import_picocolors8 = __toESM(require("picocolors"), 1);
 
 // src/interactive/prompts/multiline.ts
 var import_node_readline = require("readline");
-var import_prompts4 = require("@inquirer/prompts");
-var import_picocolors4 = __toESM(require("picocolors"), 1);
+var import_prompts3 = require("@inquirer/prompts");
+var import_picocolors7 = __toESM(require("picocolors"), 1);
 var readMultilineTextFromTerminal = async (message, endHint = "When done pasting, enter END on a new line or press Enter twice to finish") => {
-  console.log(import_picocolors4.default.cyan(`
+  console.log(import_picocolors7.default.cyan(`
 ${message}`));
-  console.log(import_picocolors4.default.dim(`  (Hint: ${endHint})
+  console.log(import_picocolors7.default.dim(`  (Hint: ${endHint})
 `));
   return new Promise((resolve) => {
     const rl = (0, import_node_readline.createInterface)({
@@ -1682,7 +2180,7 @@ ${message}`));
 };
 var promptEditorText = async (options) => {
   try {
-    return await (0, import_prompts4.editor)({
+    return await (0, import_prompts3.editor)({
       message: options.message,
       default: options.defaultText ?? "",
       postfix: options.postfix
@@ -1692,8 +2190,157 @@ var promptEditorText = async (options) => {
   }
 };
 
+// src/interactive/prompts/kv.ts
+var promptEditKeyValueConfig = async (currentItems = {}, options) => {
+  let items = { ...currentItems };
+  while (true) {
+    const keys = Object.keys(items);
+    console.log();
+    if (keys.length === 0) {
+      console.log(import_picocolors8.default.dim(`  No ${options.itemsNoun} configured.`));
+    } else {
+      console.log(import_picocolors8.default.cyan(import_picocolors8.default.bold(`  Configured ${options.title} (${keys.length}):`)));
+      for (const [k, v] of Object.entries(items)) {
+        const sep = options.separator === "=" ? "=" : ": ";
+        console.log(`    ${import_picocolors8.default.bold(k)}${sep}${import_picocolors8.default.dim(options.maskValue(k, v))}`);
+      }
+    }
+    console.log();
+    const choice = await (0, import_prompts4.select)({
+      message: `Manage ${options.itemsNoun}:`,
+      choices: [
+        {
+          name: "Open in system default editor ($EDITOR)",
+          value: "editor"
+        },
+        {
+          name: `Add or modify a ${options.itemNoun}`,
+          value: "upsert"
+        },
+        ...keys.length > 0 ? [
+          {
+            name: `Delete a ${options.itemNoun}`,
+            value: "delete"
+          }
+        ] : [],
+        {
+          name: `Paste multiline ${options.itemsNoun} into terminal`,
+          value: "paste"
+        },
+        ...keys.length > 0 ? [
+          {
+            name: `Clear all ${options.itemsNoun}`,
+            value: "clear"
+          }
+        ] : [],
+        {
+          name: `Done (finish editing ${options.itemsNoun})`,
+          value: "done"
+        }
+      ]
+    });
+    if (choice === "done") {
+      return items;
+    }
+    if (choice === "editor") {
+      const defaultText = options.formatText(items);
+      const text = await promptEditorText({
+        message: options.editorMessage,
+        postfix: options.editorPostfix,
+        defaultText
+      });
+      const parsed = options.parseText(text);
+      items = parsed;
+      logger.success(`${options.title} updated (${Object.keys(items).length} total)`);
+    } else if (choice === "upsert") {
+      const key = await (0, import_prompts4.input)({
+        message: options.keyPromptMessage,
+        validate: (val) => {
+          const trimmed = val.trim();
+          if (!trimmed) return `${options.itemNoun} name cannot be empty`;
+          if (/\s/.test(trimmed)) return `${options.itemNoun} name cannot contain spaces`;
+          return true;
+        }
+      });
+      const trimmedKey = key.trim();
+      const existingVal = items[trimmedKey];
+      const isSecret = options.isSecretKey(trimmedKey);
+      let newVal;
+      if (isSecret) {
+        newVal = await (0, import_prompts4.password)({
+          message: existingVal !== void 0 ? `New value for (${trimmedKey}) [leave empty to keep current]:` : `${options.valuePromptMessage} for (${trimmedKey}) [sensitive content masked]:`,
+          mask: "*"
+        });
+        if (existingVal !== void 0 && newVal === "") {
+          newVal = existingVal;
+        }
+      } else {
+        newVal = await (0, import_prompts4.input)({
+          message: `${options.valuePromptMessage} for (${trimmedKey}):`,
+          default: existingVal
+        });
+      }
+      items[trimmedKey] = newVal;
+      logger.success(`${existingVal !== void 0 ? "Updated" : "Added"}: ${import_picocolors8.default.cyan(trimmedKey)}`);
+    } else if (choice === "delete") {
+      const toDelete = await (0, import_prompts4.select)({
+        message: `Select ${options.itemNoun} to delete:`,
+        choices: [
+          ...keys.map((k) => ({ name: k, value: k })),
+          { name: "Cancel", value: "__cancel__" }
+        ]
+      });
+      if (toDelete !== "__cancel__") {
+        delete items[toDelete];
+        logger.success(`Deleted: ${import_picocolors8.default.cyan(toDelete)}`);
+      }
+    } else if (choice === "paste") {
+      const pasted = await readMultilineTextFromTerminal(options.pasteMessage);
+      const parsed = options.parseText(pasted);
+      const count = Object.keys(parsed).length;
+      if (count === 0) {
+        logger.warn(`No valid ${options.itemsNoun} recognized`);
+      } else {
+        if (keys.length > 0) {
+          const pasteMode = await (0, import_prompts4.select)({
+            message: `How to apply pasted ${options.itemsNoun}?`,
+            choices: [
+              { name: `Merge with existing ${options.itemsNoun}`, value: "merge" },
+              { name: `Replace all existing ${options.itemsNoun}`, value: "replace" }
+            ]
+          });
+          if (pasteMode === "replace") {
+            items = parsed;
+          } else {
+            Object.assign(items, parsed);
+          }
+        } else {
+          items = parsed;
+        }
+        logger.success(`Successfully applied ${import_picocolors8.default.cyan(String(count))} ${options.itemsNoun}`);
+      }
+    } else if (choice === "clear") {
+      const confirmClear = await (0, import_prompts4.confirm)({
+        message: `Are you sure you want to clear all ${options.itemsNoun}?`,
+        default: false
+      });
+      if (confirmClear) {
+        items = {};
+        logger.success(`Cleared all ${options.itemsNoun}`);
+      }
+    }
+  }
+};
+
 // src/interactive/prompts/env.ts
-var SECRET_KEY_PATTERN = /(token|key|secret|password|passwd|auth|credential)/i;
+var formatEnvText = (env) => {
+  return Object.entries(env).map(([key, value]) => {
+    if (/[\s"']/.test(value)) {
+      return `${key}="${value.replace(/"/g, '\\"')}"`;
+    }
+    return `${key}=${value}`;
+  }).join("\n");
+};
 var parseEnvText = (rawText) => {
   const result = {};
   const lines = rawText.split(/\r?\n/);
@@ -1719,7 +2366,7 @@ var promptEnvConfig = async (initialEnv = {}) => {
   const env = { ...initialEnv };
   const initialCount = Object.keys(env).length;
   if (initialCount > 0) {
-    logger.info(`Includes ${import_picocolors5.default.cyan(String(initialCount))} preset environment variables`);
+    logger.info(`Includes ${import_picocolors9.default.cyan(String(initialCount))} preset environment variables`);
   }
   const mode = await (0, import_prompts5.select)({
     message: "Configure environment variables?",
@@ -1748,7 +2395,8 @@ var promptEnvConfig = async (initialEnv = {}) => {
   if (mode === "paste" || mode === "editor") {
     const pasted = mode === "editor" ? await promptEditorText({
       message: "Paste or edit environment variables in editor, then save and exit:",
-      postfix: ".env"
+      postfix: ".env",
+      defaultText: formatEnvText(env)
     }) : await readMultilineTextFromTerminal("Paste .env formatted content (multiline supported):");
     const parsed = parseEnvText(pasted);
     const count = Object.keys(parsed).length;
@@ -1756,10 +2404,9 @@ var promptEnvConfig = async (initialEnv = {}) => {
       logger.warn("No valid KEY=VALUE pairs recognized");
     } else {
       Object.assign(env, parsed);
-      logger.success(`Successfully parsed ${import_picocolors5.default.cyan(String(count))} environment variables:`);
+      logger.success(`Successfully parsed ${import_picocolors9.default.cyan(String(count))} environment variables:`);
       for (const [k, v] of Object.entries(parsed)) {
-        const masked = SECRET_KEY_PATTERN.test(k) && v.length > 4 ? `${v.slice(0, 2)}***${v.slice(-2)}` : v;
-        console.log(`  ${import_picocolors5.default.bold(k)}=${import_picocolors5.default.dim(masked)}`);
+        console.log(`  ${import_picocolors9.default.bold(k)}=${import_picocolors9.default.dim(maskSecretValue(k, v))}`);
       }
     }
     return env;
@@ -1790,15 +2437,32 @@ var promptEnvConfig = async (initialEnv = {}) => {
       });
     }
     env[trimmedKey] = val;
-    logger.success(`Added: ${import_picocolors5.default.cyan(trimmedKey)}`);
+    logger.success(`Added: ${import_picocolors9.default.cyan(trimmedKey)}`);
   }
   return env;
 };
+var promptEditEnvConfig = async (currentEnv = {}) => promptEditKeyValueConfig(currentEnv, {
+  title: "Environment Variables",
+  itemNoun: "variable",
+  itemsNoun: "environment variables",
+  separator: "=",
+  editorPostfix: ".env",
+  editorMessage: "Edit environment variables in editor, then save and exit:",
+  pasteMessage: "Paste .env formatted content (multiline supported):",
+  keyPromptMessage: "Variable name (Key):",
+  valuePromptMessage: "Value",
+  isSecretKey: (k) => SECRET_KEY_PATTERN.test(k),
+  maskValue: maskSecretValue,
+  formatText: formatEnvText,
+  parseText: parseEnvText
+});
 
 // src/interactive/prompts/headers.ts
 var import_prompts6 = require("@inquirer/prompts");
-var import_picocolors6 = __toESM(require("picocolors"), 1);
-var SECRET_HEADER_PATTERN = /(authorization|token|key|secret|auth)/i;
+var import_picocolors10 = __toESM(require("picocolors"), 1);
+var formatHeadersText = (headers) => {
+  return Object.entries(headers).map(([key, value]) => `${key}: ${value}`).join("\n");
+};
 var parseHeadersText = (rawText) => {
   const result = {};
   const lines = rawText.split(/\r?\n/);
@@ -1854,7 +2518,8 @@ var promptHeadersConfig = async (initialHeaders = {}) => {
   }
   if (mode === "paste" || mode === "editor") {
     const pasted = mode === "editor" ? await promptEditorText({
-      message: "Paste or edit HTTP headers in editor, then save and exit:"
+      message: "Paste or edit HTTP headers in editor, then save and exit:",
+      defaultText: formatHeadersText(headers)
     }) : await readMultilineTextFromTerminal(
       "Paste HTTP headers content (multiline supported, e.g. Authorization: Bearer ...):"
     );
@@ -1864,10 +2529,9 @@ var promptHeadersConfig = async (initialHeaders = {}) => {
       logger.warn("No valid Key: Value pairs recognized");
     } else {
       Object.assign(headers, parsed);
-      logger.success(`Successfully parsed ${import_picocolors6.default.cyan(String(count))} headers:`);
+      logger.success(`Successfully parsed ${import_picocolors10.default.cyan(String(count))} headers:`);
       for (const [k, v] of Object.entries(parsed)) {
-        const masked = SECRET_HEADER_PATTERN.test(k) && v.length > 8 ? `${v.slice(0, 4)}***${v.slice(-3)}` : v;
-        console.log(`  ${import_picocolors6.default.bold(k)}: ${import_picocolors6.default.dim(masked)}`);
+        console.log(`  ${import_picocolors10.default.bold(k)}: ${import_picocolors10.default.dim(maskSecretHeader(k, v))}`);
       }
     }
     return headers;
@@ -1898,15 +2562,29 @@ var promptHeadersConfig = async (initialHeaders = {}) => {
       });
     }
     headers[trimmedName] = val;
-    logger.success(`Added: ${import_picocolors6.default.cyan(trimmedName)}`);
+    logger.success(`Added: ${import_picocolors10.default.cyan(trimmedName)}`);
   }
   return headers;
 };
+var promptEditHeadersConfig = async (currentHeaders = {}) => promptEditKeyValueConfig(currentHeaders, {
+  title: "HTTP Headers",
+  itemNoun: "header",
+  itemsNoun: "HTTP headers",
+  separator: ":",
+  editorMessage: "Edit HTTP headers in editor, then save and exit:",
+  pasteMessage: "Paste HTTP headers content (multiline supported, e.g. Authorization: Bearer ...):",
+  keyPromptMessage: "Header name (e.g. Authorization):",
+  valuePromptMessage: "Header value",
+  isSecretKey: (k) => SECRET_HEADER_PATTERN.test(k),
+  maskValue: maskSecretHeader,
+  formatText: formatHeadersText,
+  parseText: parseHeadersText
+});
 
 // src/interactive/wizard-add.ts
 var wizardAdd = async (initial = {}) => {
   const cwd = initial.cwd ?? process.cwd();
-  logger.info(import_picocolors7.default.bold("Welcome to the MCP interactive add wizard"));
+  logger.info(import_picocolors11.default.bold("Welcome to the MCP interactive add wizard"));
   let source = initial.source;
   if (!source) {
     const sourceType = await (0, import_prompts7.select)({
@@ -1928,7 +2606,7 @@ var wizardAdd = async (initial = {}) => {
     });
     if (sourceType === "npm") {
       source = await (0, import_prompts7.input)({
-        message: "Enter npm package name (e.g. @modelcontextprotocol/server-postgres or mcp-server-git):",
+        message: "Enter npm package name (e.g. @modelcontextprotocol/server-postgres):",
         validate: (val) => val.trim() ? true : "Package name cannot be empty"
       });
     } else if (sourceType === "remote") {
@@ -1996,25 +2674,25 @@ var wizardAdd = async (initial = {}) => {
   if (parsed.type !== "remote") {
     env = await promptEnvConfig(env);
   }
-  console.log("\n" + import_picocolors7.default.cyan(import_picocolors7.default.bold("Configuration Preview:")));
-  console.log(`  ${import_picocolors7.default.bold("Server Name:")} ${import_picocolors7.default.green(serverName)}`);
-  console.log(`  ${import_picocolors7.default.bold("Server Type:")} ${import_picocolors7.default.magenta(parsed.type)}`);
-  console.log(`  ${import_picocolors7.default.bold("Source/Command:")} ${import_picocolors7.default.dim(source)}`);
-  console.log(`  ${import_picocolors7.default.bold("Scope:")} ${isGlobal ? import_picocolors7.default.yellow("Global") : import_picocolors7.default.blue("Project")}`);
-  console.log(`  ${import_picocolors7.default.bold("Target Agents:")} ${import_picocolors7.default.cyan(selectedAgents.join(", "))}`);
+  console.log("\n" + import_picocolors11.default.cyan(import_picocolors11.default.bold("Configuration Preview:")));
+  console.log(`  ${import_picocolors11.default.bold("Server Name:")} ${import_picocolors11.default.green(serverName)}`);
+  console.log(`  ${import_picocolors11.default.bold("Server Type:")} ${import_picocolors11.default.magenta(parsed.type)}`);
+  console.log(`  ${import_picocolors11.default.bold("Source/Command:")} ${import_picocolors11.default.dim(source)}`);
+  console.log(`  ${import_picocolors11.default.bold("Scope:")} ${isGlobal ? import_picocolors11.default.yellow("Global") : import_picocolors11.default.blue("Project")}`);
+  console.log(`  ${import_picocolors11.default.bold("Target Agents:")} ${import_picocolors11.default.cyan(selectedAgents.join(", "))}`);
   if (args.length > 0) {
-    console.log(`  ${import_picocolors7.default.bold("Arguments:")} ${import_picocolors7.default.dim(args.join(" "))}`);
+    console.log(`  ${import_picocolors11.default.bold("Arguments:")} ${import_picocolors11.default.dim(args.join(" "))}`);
   }
   if (transport) {
-    console.log(`  ${import_picocolors7.default.bold("Transport:")} ${import_picocolors7.default.magenta(transport)}`);
+    console.log(`  ${import_picocolors11.default.bold("Transport:")} ${import_picocolors11.default.magenta(transport)}`);
   }
   const envKeys = Object.keys(env);
   if (envKeys.length > 0) {
-    console.log(`  ${import_picocolors7.default.bold("Environment Variables:")} ${import_picocolors7.default.dim(envKeys.join(", "))} (${envKeys.length})`);
+    console.log(`  ${import_picocolors11.default.bold("Environment Variables:")} ${import_picocolors11.default.dim(envKeys.join(", "))} (${envKeys.length})`);
   }
   const headerKeys = Object.keys(headers);
   if (headerKeys.length > 0) {
-    console.log(`  ${import_picocolors7.default.bold("Headers:")} ${import_picocolors7.default.dim(headerKeys.join(", "))} (${headerKeys.length})`);
+    console.log(`  ${import_picocolors11.default.bold("Headers:")} ${import_picocolors11.default.dim(headerKeys.join(", "))} (${headerKeys.length})`);
   }
   console.log();
   const proceed = await (0, import_prompts7.confirm)({
@@ -2037,41 +2715,103 @@ var wizardAdd = async (initial = {}) => {
     env
   });
   logger.info(
-    `Writing ${import_picocolors7.default.bold(result.serverName)} to ${import_picocolors7.default.cyan(String(result.results.length))} agent config files...`
+    `Writing ${import_picocolors11.default.bold(result.serverName)} to ${import_picocolors11.default.cyan(String(result.results.length))} agent config files...`
   );
   let allSuccess = true;
   for (const record of result.results) {
     if (record.success) {
-      logger.success(`${import_picocolors7.default.cyan(record.agent)}: Successfully written to ${import_picocolors7.default.dim(record.path)}`);
+      logger.success(
+        `${import_picocolors11.default.cyan(record.agent)}: Successfully written to ${import_picocolors11.default.dim(record.path)}${formatCoHostedBadge("configured", record.coConfiguredAgents)}`
+      );
     } else {
       allSuccess = false;
-      logger.error(`${import_picocolors7.default.cyan(record.agent)}: Failed to write - ${record.error}`);
+      logger.error(`${import_picocolors11.default.cyan(record.agent)}: Failed to write - ${record.error}`);
     }
   }
   if (allSuccess) {
-    logger.success(import_picocolors7.default.bold(`MCP server "${serverName}" configured successfully!`));
+    logger.success(import_picocolors11.default.bold(`MCP server "${serverName}" configured successfully!`));
   }
   return allSuccess;
 };
 
 // src/interactive/wizard-manage.ts
 var import_prompts8 = require("@inquirer/prompts");
-var import_picocolors8 = __toESM(require("picocolors"), 1);
+var import_picocolors13 = __toESM(require("picocolors"), 1);
+
+// src/utils/display-server-details.ts
+var import_picocolors12 = __toESM(require("picocolors"), 1);
+var displayServerDetails = ({
+  serverName,
+  config,
+  agents,
+  hasDivergence,
+  global: isGlobal,
+  titlePrefix = "MCP Server Details"
+}) => {
+  console.log("\n" + import_picocolors12.default.cyan(import_picocolors12.default.bold(`${titlePrefix}: [${serverName}]`)));
+  if (isGlobal !== void 0) {
+    console.log(`  ${import_picocolors12.default.bold("Scope:")} ${isGlobal ? "Global" : "Project"}`);
+  }
+  if (agents && agents.length > 0) {
+    console.log(
+      `  ${import_picocolors12.default.bold("Configured Agents:")} ${import_picocolors12.default.green(agents.map((a) => getMcpAgentConfig(a).displayName).join(", "))}`
+    );
+  }
+  if (hasDivergence) {
+    console.log(
+      `  ${import_picocolors12.default.yellow(import_picocolors12.default.bold("Notice:"))} ${import_picocolors12.default.yellow("Configurations differ across installed agents. Showing configuration from the first agent.")}`
+    );
+  }
+  const isRemote = Boolean(config.url && config.url.length > 0);
+  if (isRemote) {
+    console.log(`  ${import_picocolors12.default.bold("Transport:")} ${import_picocolors12.default.magenta(config.type ?? "http")}`);
+    console.log(`  ${import_picocolors12.default.bold("URL:")} ${import_picocolors12.default.dim(config.url ?? "")}`);
+    const headerKeys = Object.keys(config.headers ?? {});
+    if (headerKeys.length > 0) {
+      console.log(`  ${import_picocolors12.default.bold("Headers:")} ${import_picocolors12.default.cyan(String(headerKeys.length))}`);
+      for (const [k, v] of Object.entries(config.headers ?? {})) {
+        console.log(`    ${import_picocolors12.default.bold(k)}: ${import_picocolors12.default.dim(maskSecretHeader(k, v))}`);
+      }
+    } else {
+      console.log(`  ${import_picocolors12.default.bold("Headers:")} ${import_picocolors12.default.dim("(none)")}`);
+    }
+  } else {
+    console.log(`  ${import_picocolors12.default.bold("Command:")} ${import_picocolors12.default.magenta(config.command ?? "")}`);
+    const argsStr = config.args && config.args.length > 0 ? config.args.join(" ") : "(none)";
+    console.log(`  ${import_picocolors12.default.bold("Arguments:")} ${import_picocolors12.default.dim(argsStr)}`);
+    const envKeys = Object.keys(config.env ?? {});
+    if (envKeys.length > 0) {
+      console.log(`  ${import_picocolors12.default.bold("Environment Variables:")} ${import_picocolors12.default.cyan(String(envKeys.length))}`);
+      for (const [k, v] of Object.entries(config.env ?? {})) {
+        console.log(`    ${import_picocolors12.default.bold(k)}=${import_picocolors12.default.dim(maskSecretValue(k, v))}`);
+      }
+    } else {
+      console.log(`  ${import_picocolors12.default.bold("Environment Variables:")} ${import_picocolors12.default.dim("(none)")}`);
+    }
+  }
+  console.log();
+};
 
 // src/interactive/utils/group-installed-servers.ts
 var normalizeServerConfig = parseServerConfig;
 var groupInstalledServersByName = (installed) => {
   const grouped = /* @__PURE__ */ new Map();
   for (const item of installed) {
+    const itemConfig = normalizeServerConfig(item.config);
     let entry = grouped.get(item.serverName);
     if (!entry) {
       entry = {
         serverName: item.serverName,
         agents: [],
         paths: [],
-        config: normalizeServerConfig(item.config)
+        config: itemConfig,
+        hasDivergence: false
       };
       grouped.set(item.serverName, entry);
+    } else if (!entry.hasDivergence) {
+      if (JSON.stringify(entry.config) !== JSON.stringify(itemConfig)) {
+        entry.hasDivergence = true;
+      }
     }
     if (!entry.agents.includes(item.agent)) {
       entry.agents.push(item.agent);
@@ -2084,6 +2824,221 @@ var groupInstalledServersByName = (installed) => {
 };
 
 // src/interactive/wizard-manage.ts
+var promptSwitchServerType = async (currentConfig, serverName) => {
+  const isRemote = Boolean(currentConfig.url && currentConfig.url.length > 0);
+  if (isRemote) {
+    const newCmd = await (0, import_prompts8.input)({
+      message: "Executable command (e.g. node, npx):",
+      validate: (val) => val.trim() ? true : "Command cannot be empty"
+    });
+    const newArgs = await promptEditArgs([]);
+    const newEnv = await promptEditEnvConfig({});
+    logger.success(`Switched [${serverName}] configuration to stdio mode`);
+    return {
+      command: newCmd.trim(),
+      args: newArgs.length > 0 ? newArgs : void 0,
+      env: Object.keys(newEnv).length > 0 ? newEnv : void 0
+    };
+  }
+  const newUrl = await (0, import_prompts8.input)({
+    message: "Remote server URL:",
+    validate: (val) => {
+      const trimmed = val.trim();
+      if (!trimmed) return "URL cannot be empty";
+      if (!/^https?:\/\//i.test(trimmed)) {
+        return "Please enter a valid URL starting with http:// or https://";
+      }
+      return true;
+    }
+  });
+  const transport = await (0, import_prompts8.select)({
+    message: "Select remote transport protocol:",
+    choices: [
+      { name: "HTTP", value: "http" },
+      { name: "SSE (Server-Sent Events)", value: "sse" }
+    ],
+    default: "http"
+  });
+  const newHeaders = await promptEditHeadersConfig({});
+  logger.success(`Switched [${serverName}] configuration to remote mode`);
+  return {
+    url: newUrl.trim(),
+    type: transport,
+    headers: Object.keys(newHeaders).length > 0 ? newHeaders : void 0
+  };
+};
+var handleEditServerConfig = async (options) => {
+  const { targetGroup } = options;
+  const isGlobal = options.global ?? false;
+  const cwd = options.cwd ?? process.cwd();
+  const serverName = targetGroup.serverName;
+  let workingConfig = {
+    ...targetGroup.config,
+    args: targetGroup.config.args ? [...targetGroup.config.args] : void 0,
+    env: targetGroup.config.env ? { ...targetGroup.config.env } : void 0,
+    headers: targetGroup.config.headers ? { ...targetGroup.config.headers } : void 0
+  };
+  while (true) {
+    const isRemote = Boolean(workingConfig.url && workingConfig.url.length > 0);
+    displayServerDetails({
+      serverName,
+      config: workingConfig,
+      titlePrefix: "Edit Server Configuration"
+    });
+    const editChoices = isRemote ? [
+      { name: "Edit HTTP Headers (headers)", value: "headers" },
+      { name: "Edit Remote URL (url)", value: "url" },
+      { name: "Edit Transport Protocol (type)", value: "transport" },
+      { name: "Switch to local command (stdio)", value: "switch_type" },
+      { name: "Reset changes to original", value: "reset" },
+      { name: "Save and apply changes", value: "save" },
+      { name: "Cancel (discard changes)", value: "cancel" }
+    ] : [
+      { name: "Edit Environment Variables (env)", value: "env" },
+      { name: "Edit Command Arguments (args)", value: "args" },
+      { name: "Edit Executable Command (command)", value: "command" },
+      { name: "Switch to remote server (HTTP/SSE)", value: "switch_type" },
+      { name: "Reset changes to original", value: "reset" },
+      { name: "Save and apply changes", value: "save" },
+      { name: "Cancel (discard changes)", value: "cancel" }
+    ];
+    const editAction = await (0, import_prompts8.select)({
+      message: `What would you like to modify in [${serverName}]?`,
+      choices: editChoices
+    });
+    if (editAction === "cancel") {
+      logger.info("Modification cancelled; changes discarded");
+      return;
+    }
+    if (editAction === "reset") {
+      workingConfig = {
+        ...targetGroup.config,
+        args: targetGroup.config.args ? [...targetGroup.config.args] : void 0,
+        env: targetGroup.config.env ? { ...targetGroup.config.env } : void 0,
+        headers: targetGroup.config.headers ? { ...targetGroup.config.headers } : void 0
+      };
+      logger.info("Configuration reset to original");
+      continue;
+    }
+    if (editAction === "switch_type") {
+      workingConfig = await promptSwitchServerType(workingConfig, serverName);
+      continue;
+    }
+    if (editAction === "env") {
+      workingConfig.env = await promptEditEnvConfig(workingConfig.env ?? {});
+    } else if (editAction === "args") {
+      workingConfig.args = await promptEditArgs(workingConfig.args ?? []);
+    } else if (editAction === "command") {
+      const newCmd = await (0, import_prompts8.input)({
+        message: "Executable command:",
+        default: workingConfig.command,
+        validate: (val) => val.trim() ? true : "Command cannot be empty"
+      });
+      workingConfig.command = newCmd.trim();
+    } else if (editAction === "headers") {
+      workingConfig.headers = await promptEditHeadersConfig(workingConfig.headers ?? {});
+    } else if (editAction === "url") {
+      const newUrl = await (0, import_prompts8.input)({
+        message: "Remote server URL:",
+        default: workingConfig.url,
+        validate: (val) => {
+          const trimmed = val.trim();
+          if (!trimmed) return "URL cannot be empty";
+          if (!/^https?:\/\//i.test(trimmed)) {
+            return "Please enter a valid URL starting with http:// or https://";
+          }
+          return true;
+        }
+      });
+      workingConfig.url = newUrl.trim();
+    } else if (editAction === "transport") {
+      workingConfig.type = await (0, import_prompts8.select)({
+        message: "Select remote transport protocol:",
+        choices: [
+          { name: "HTTP", value: "http" },
+          { name: "SSE (Server-Sent Events)", value: "sse" }
+        ],
+        default: workingConfig.type === "sse" ? "sse" : "http"
+      });
+    } else if (editAction === "save") {
+      let targetAgents = targetGroup.agents;
+      if (targetGroup.agents.length > 1) {
+        const sortedAgents = sortAgentsWithClusters(targetGroup.agents, { global: isGlobal, cwd });
+        const choices = buildLinkedAgentChoices({
+          agents: sortedAgents,
+          checkedAgents: sortedAgents,
+          scopeOptions: { global: isGlobal, cwd }
+        });
+        targetAgents = await linkedCheckbox({
+          message: "Select agents to update configuration (Space to toggle):",
+          choices,
+          loop: false,
+          validate: (ans) => ans.length === 0 ? "Please select at least one agent" : true
+        });
+        if (targetAgents.length < targetGroup.agents.length) {
+          const unselected = targetGroup.agents.filter((a) => !targetAgents.includes(a));
+          const unselectedNames = unselected.map((a) => getMcpAgentConfig(a).displayName).join(", ");
+          logger.info(
+            `Note: Updating only a subset of agents. Server configurations will diverge from: ${unselectedNames}.`
+          );
+        }
+      }
+      const requestedTransport = workingConfig.url ? workingConfig.type ?? "http" : "stdio";
+      const resolution = resolveTargetAgents({
+        requested: targetAgents,
+        global: isGlobal,
+        cwd,
+        transport: requestedTransport
+      });
+      if (resolution.incompatible.length > 0) {
+        for (const item of resolution.incompatible) {
+          logger.warn(`Skipping ${import_picocolors13.default.cyan(item.agent)}: ${item.reason}`);
+        }
+      }
+      if (resolution.compatibleAgents.length === 0) {
+        logger.error(
+          `None of the selected agents support ${requestedTransport} transport. Cannot update.`
+        );
+        continue;
+      }
+      const agentNames = resolution.compatibleAgents.map((a) => getMcpAgentConfig(a).displayName).join(", ");
+      const confirmed = await (0, import_prompts8.confirm)({
+        message: `Confirm updating configuration for [${serverName}] across: ${agentNames}?`,
+        default: true
+      });
+      if (!confirmed) {
+        logger.warn("Update cancelled");
+        continue;
+      }
+      const updateResult = updateMcpServer({
+        serverName,
+        config: workingConfig,
+        previousConfig: targetGroup.config,
+        agents: resolution.compatibleAgents,
+        global: isGlobal,
+        cwd
+      });
+      let updatedAny = false;
+      const succeededAgents = [];
+      for (const res of updateResult.results) {
+        if (res.success) {
+          updatedAny = true;
+          succeededAgents.push(res.agent);
+          logger.success(
+            `${import_picocolors13.default.cyan(res.agent)}: Successfully updated configuration in ${import_picocolors13.default.dim(res.path)}${formatCoHostedBadge("configured", res.coConfiguredAgents)}`
+          );
+        } else {
+          logger.error(`${import_picocolors13.default.cyan(res.agent)}: Update failed - ${res.error}`);
+        }
+      }
+      if (updatedAny) {
+        targetGroup.config = updateResult.config;
+        logger.success(`Configuration for [${serverName}] updated successfully!`);
+        return;
+      }
+    }
+  }
+};
 var wizardManage = async (options = {}) => {
   const cwd = options.cwd ?? process.cwd();
   const isGlobal = await promptScope({
@@ -2097,51 +3052,57 @@ var wizardManage = async (options = {}) => {
     return;
   }
   const grouped = groupInstalledServersByName(installed);
+  let pendingServerName = options.serverName;
+  const refreshGroupedServers = () => {
+    const freshInstalled = listInstalledMcpServers({ global: isGlobal, cwd });
+    const freshGrouped = groupInstalledServersByName(freshInstalled);
+    grouped.clear();
+    for (const [name, grp] of freshGrouped) {
+      grouped.set(name, grp);
+    }
+  };
   while (true) {
-    const choices = Array.from(grouped.values()).map((g) => {
-      const agentNames = g.agents.map((a) => getMcpAgentConfig(a).displayName).join(", ");
-      return {
-        name: `${import_picocolors8.default.bold(g.serverName)} ${import_picocolors8.default.dim(`(configured in: ${agentNames})`)}`,
-        value: g.serverName
-      };
-    });
-    choices.push({
-      name: `Back`,
-      value: "__back__"
-    });
-    const chosenServerName = await (0, import_prompts8.select)({
-      message: "Select MCP server to manage or sync:",
-      choices
-    });
-    if (chosenServerName === "__back__") {
-      return;
+    let chosenServerName;
+    if (pendingServerName && grouped.has(pendingServerName)) {
+      chosenServerName = pendingServerName;
+      pendingServerName = void 0;
+    } else {
+      pendingServerName = void 0;
+      const choices = Array.from(grouped.values()).map((g) => {
+        const agentNames = g.agents.map((a) => getMcpAgentConfig(a).displayName).join(", ");
+        return {
+          name: `${import_picocolors13.default.bold(g.serverName)} ${import_picocolors13.default.dim(`(configured in: ${agentNames})`)}`,
+          value: g.serverName
+        };
+      });
+      choices.push({
+        name: `Back`,
+        value: "__back__"
+      });
+      chosenServerName = await (0, import_prompts8.select)({
+        message: "Select MCP server to manage or sync:",
+        choices
+      });
+      if (chosenServerName === "__back__") {
+        return;
+      }
     }
     const targetGroup = grouped.get(chosenServerName);
     if (!targetGroup) continue;
-    console.log("\n" + import_picocolors8.default.cyan(import_picocolors8.default.bold(`MCP Server Details: [${chosenServerName}]`)));
-    console.log(`  ${import_picocolors8.default.bold("Scope:")} ${isGlobal ? "Global" : "Project"}`);
-    console.log(
-      `  ${import_picocolors8.default.bold("Configured Agents:")} ${import_picocolors8.default.green(targetGroup.agents.map((a) => getMcpAgentConfig(a).displayName).join(", "))}`
-    );
-    const cfg = targetGroup.config;
-    if (isRemoteServerConfig(cfg)) {
-      console.log(`  ${import_picocolors8.default.bold("URL:")} ${import_picocolors8.default.dim(cfg.url)} (${cfg.type})`);
-      if (cfg.headers && Object.keys(cfg.headers).length > 0) {
-        console.log(`  ${import_picocolors8.default.bold("Headers:")} ${Object.keys(cfg.headers).join(", ")}`);
-      }
-    } else if (isStdioServerConfig(cfg)) {
-      console.log(`  ${import_picocolors8.default.bold("Command:")} ${import_picocolors8.default.magenta(cfg.command)}`);
-      if (cfg.args && cfg.args.length > 0) {
-        console.log(`  ${import_picocolors8.default.bold("Arguments:")} ${import_picocolors8.default.dim(cfg.args.join(" "))}`);
-      }
-      if (cfg.env && Object.keys(cfg.env).length > 0) {
-        console.log(`  ${import_picocolors8.default.bold("Environment Variables:")} ${import_picocolors8.default.dim(Object.keys(cfg.env).join(", "))}`);
-      }
-    }
-    console.log();
+    displayServerDetails({
+      serverName: chosenServerName,
+      config: targetGroup.config,
+      agents: targetGroup.agents,
+      global: isGlobal,
+      hasDivergence: targetGroup.hasDivergence
+    });
     const action = await (0, import_prompts8.select)({
       message: `What would you like to do with [${chosenServerName}]?`,
       choices: [
+        {
+          name: "Edit server configuration",
+          value: "edit"
+        },
         {
           name: "Sync / clone to other agents",
           value: "sync"
@@ -2153,20 +3114,34 @@ var wizardManage = async (options = {}) => {
       ]
     });
     if (action === "back") continue;
+    if (action === "edit") {
+      await handleEditServerConfig({
+        targetGroup,
+        global: isGlobal,
+        cwd
+      });
+      refreshGroupedServers();
+      continue;
+    }
     if (action === "sync") {
       const allAllowedAgents = isGlobal ? getMcpAgentTypes() : getMcpAgentsSupportingProjectScope();
-      const candidateAgents = allAllowedAgents.filter((a) => !targetGroup.agents.includes(a));
-      if (candidateAgents.length === 0) {
-        logger.info("All supported agents in this scope already have this MCP server configured; no sync needed");
+      const rawCandidateAgents = allAllowedAgents.filter((a) => !targetGroup.agents.includes(a));
+      if (rawCandidateAgents.length === 0) {
+        logger.info(
+          "All supported agents in this scope already have this MCP server configured; no sync needed"
+        );
         continue;
       }
-      const selectedToSync = await (0, import_prompts8.checkbox)({
+      const candidateAgents = sortAgentsWithClusters(rawCandidateAgents, { global: isGlobal, cwd });
+      const choices = buildLinkedAgentChoices({
+        agents: candidateAgents,
+        checkedAgents: [],
+        scopeOptions: { global: isGlobal, cwd }
+      });
+      const selectedToSync = await linkedCheckbox({
         message: "Select target agents to sync to (Space to select):",
-        choices: candidateAgents.map((a) => ({
-          name: `${getMcpAgentConfig(a).displayName} (${a})`,
-          value: a,
-          checked: false
-        })),
+        choices,
+        loop: false,
         validate: (ans) => ans.length === 0 ? "Please select at least one agent" : true
       });
       const confirmed = await (0, import_prompts8.confirm)({
@@ -2177,25 +3152,37 @@ var wizardManage = async (options = {}) => {
         logger.warn("Sync cancelled");
         continue;
       }
-      for (const targetAgent of selectedToSync) {
-        const res = installMcpServerForAgent(chosenServerName, targetGroup.config, targetAgent, {
-          global: isGlobal,
-          cwd
-        });
+      const syncResult = updateMcpServer({
+        serverName: chosenServerName,
+        config: targetGroup.config,
+        agents: selectedToSync,
+        global: isGlobal,
+        cwd
+      });
+      for (const item of syncResult.incompatible) {
+        logger.warn(`Skipping ${import_picocolors13.default.cyan(item.agent)}: ${item.reason}`);
+      }
+      for (const res of syncResult.results) {
+        if (syncResult.incompatible.some((i) => i.agent === res.agent)) {
+          continue;
+        }
         if (res.success) {
-          logger.success(`${import_picocolors8.default.cyan(targetAgent)}: Successfully synced to ${import_picocolors8.default.dim(res.path)}`);
-          targetGroup.agents.push(targetAgent);
+          logger.success(
+            `${import_picocolors13.default.cyan(res.agent)}: Successfully synced to ${import_picocolors13.default.dim(res.path)}${formatCoHostedBadge("configured", res.coConfiguredAgents)}`
+          );
+          targetGroup.agents.push(res.agent);
         } else {
-          logger.error(`${import_picocolors8.default.cyan(targetAgent)}: Sync failed - ${res.error}`);
+          logger.error(`${import_picocolors13.default.cyan(res.agent)}: Sync failed - ${res.error}`);
         }
       }
+      refreshGroupedServers();
     }
   }
 };
 
 // src/interactive/wizard-remove.ts
 var import_prompts9 = require("@inquirer/prompts");
-var import_picocolors9 = __toESM(require("picocolors"), 1);
+var import_picocolors14 = __toESM(require("picocolors"), 1);
 var wizardRemove = async (options = {}) => {
   const cwd = options.cwd ?? process.cwd();
   const isGlobal = await promptScope({
@@ -2212,7 +3199,7 @@ var wizardRemove = async (options = {}) => {
   let serverName = options.name;
   if (!serverName) {
     const choices = Array.from(serverMap.values()).map((g) => ({
-      name: `${import_picocolors9.default.bold(g.serverName)} ${import_picocolors9.default.dim(`(installed in: ${g.agents.map((a) => getMcpAgentConfig(a).displayName).join(", ")})`)}`,
+      name: `${import_picocolors14.default.bold(g.serverName)} ${import_picocolors14.default.dim(`(installed in: ${g.agents.map((a) => getMcpAgentConfig(a).displayName).join(", ")})`)}`,
       value: g.serverName
     }));
     serverName = await (0, import_prompts9.select)({
@@ -2220,20 +3207,22 @@ var wizardRemove = async (options = {}) => {
       choices
     });
   }
-  const installedAgents = serverMap.get(serverName)?.agents || [];
-  if (installedAgents.length === 0) {
+  const rawInstalledAgents = serverMap.get(serverName)?.agents || [];
+  if (rawInstalledAgents.length === 0) {
     logger.warn(`No agents found with [${serverName}] installed`);
     return false;
   }
+  const installedAgents = sortAgentsWithClusters(rawInstalledAgents, { global: isGlobal, cwd });
   let targetAgents = options.agents;
   if (!targetAgents || targetAgents.length === 0) {
-    targetAgents = await (0, import_prompts9.checkbox)({
+    const choices = buildLinkedAgentChoices({
+      agents: installedAgents,
+      checkedAgents: installedAgents,
+      scopeOptions: { global: isGlobal, cwd }
+    });
+    targetAgents = await linkedCheckbox({
       message: `Select agents to remove [${serverName}] from:`,
-      choices: installedAgents.map((agent) => ({
-        name: `${getMcpAgentConfig(agent)?.displayName ?? agent} (${agent})`,
-        value: agent,
-        checked: true
-      })),
+      choices,
       validate: (ans) => ans.length === 0 ? "Please select at least one agent" : true
     });
   } else {
@@ -2261,10 +3250,12 @@ var wizardRemove = async (options = {}) => {
   let removedCount = 0;
   for (const res of results) {
     if (res.removed) {
-      logger.success(`${import_picocolors9.default.cyan(res.agent)}: Successfully removed from ${import_picocolors9.default.dim(res.path)}`);
+      logger.success(
+        `${import_picocolors14.default.cyan(res.agent)}: Successfully removed from ${import_picocolors14.default.dim(res.path)}${formatCoHostedBadge("affected", res.coAffectedAgents)}`
+      );
       removedCount++;
     } else if (res.error) {
-      logger.error(`${import_picocolors9.default.cyan(res.agent)}: Failed to remove - ${res.error}`);
+      logger.error(`${import_picocolors14.default.cyan(res.agent)}: Failed to remove - ${res.error}`);
     }
   }
   if (removedCount > 0) {
@@ -2278,8 +3269,8 @@ var wizardRemove = async (options = {}) => {
 // src/interactive/main-menu.ts
 var mainMenu = async () => {
   console.log();
-  console.log(import_picocolors10.default.bold(import_picocolors10.default.cyan("mcps - Cross-Platform MCP Manager for AI Coding Agents")));
-  console.log(import_picocolors10.default.dim("Cross-platform MCP server configuration & synchronization tool"));
+  console.log(import_picocolors15.default.bold(import_picocolors15.default.cyan("mcps - Cross-Platform MCP Manager for AI Coding Agents")));
+  console.log(import_picocolors15.default.dim("Cross-platform MCP server configuration & synchronization tool"));
   console.log();
   while (true) {
     try {
@@ -2305,7 +3296,7 @@ var mainMenu = async () => {
         ]
       });
       if (action === "exit") {
-        console.log(import_picocolors10.default.dim("Goodbye!"));
+        console.log(import_picocolors15.default.dim("Goodbye!"));
         break;
       }
       if (action === "add") {
@@ -2318,7 +3309,7 @@ var mainMenu = async () => {
       console.log();
     } catch (error) {
       if (error?.name === "ExitPromptError") {
-        console.log("\n" + import_picocolors10.default.dim("Exited."));
+        console.log("\n" + import_picocolors15.default.dim("Exited."));
         break;
       }
       throw error;
@@ -2326,10 +3317,18 @@ var mainMenu = async () => {
   }
 };
 
-// src/utils/format-agent-list.ts
-var formatAgentList = (agentList, emptyLabel = "(none)") => agentList.length === 0 ? emptyLabel : agentList.join(", ");
+// src/utils/resolve-transport.ts
+var resolveTransport = (input7) => {
+  if (!input7) return void 0;
+  if (input7 === "http" || input7 === "sse") return input7;
+  throw new Error(`Unsupported transport "${input7}" (expected: http, sse)`);
+};
 
-// src/cli/add.ts
+// src/cli/manage.ts
+var import_commander = require("commander");
+var import_picocolors16 = __toESM(require("picocolors"), 1);
+
+// src/utils/parse-key-value-list.ts
 var parseKeyValueList = (entries, separator) => {
   if (!entries || entries.length === 0) return {};
   const result = {};
@@ -2345,12 +3344,189 @@ var parseKeyValueList = (entries, separator) => {
   }
   return result;
 };
-var resolveTransport = (input5) => {
-  if (!input5) return void 0;
-  if (input5 === "http" || input5 === "sse") return input5;
-  throw new Error(`Unsupported transport "${input5}" (expected: http, sse)`);
+
+// src/cli/manage.ts
+var requireTargetServerGroup = (serverName, scope) => {
+  const installed = listInstalledMcpServers(scope);
+  const grouped = groupInstalledServersByName(installed);
+  const targetGroup = grouped.get(serverName);
+  if (!targetGroup) {
+    logger.error(
+      `MCP server "${serverName}" is not configured in ${scope.global ? "global" : "project"} scope.`
+    );
+    process.exitCode = 1;
+    return void 0;
+  }
+  return targetGroup;
 };
-var mcpAddCommand = new import_commander.Command("add").description("Add an MCP server to coding agents").argument("[source]", "Remote URL, npm package, or command line").option("-a, --agent <agents...>", "Target specific agents (use '*' for all)").option("-g, --global", "Install to user-level config instead of project").option("-t, --transport <type>", "Transport type for remote servers (http or sse)").option("--header <header...>", "HTTP header (Key: Value), repeatable").option("--env <env...>", "Env var for stdio servers (KEY=VALUE), repeatable").option("--args <args...>", "CLI arguments for stdio/package servers").option("-n, --name <name>", "Server name override").option("-y, --yes", "Skip all prompts").option("--all", "Install to all supported agents").action(async (source, options) => {
+var mcpManageCommand = new import_commander.Command("manage").description("Inspect, modify, and sync installed MCP servers across coding agents").argument("[server-name]", "Optional server name to inspect or manage").option("-a, --agent <agents...>", "Target specific agents for update").option("-g, --global", "Manage global scope servers instead of project").option("-t, --transport <type>", "Transport type for remote servers (http or sse)").option("--header <header...>", "HTTP header (Header: Value), repeatable").option("--clear-headers", "Clear all HTTP headers for remote servers").option("--env <env...>", "Env var for stdio servers (KEY=VALUE), repeatable").option("--clear-env", "Clear all environment variables for stdio servers").option("--args <args...>", "CLI arguments for stdio/package servers").option("--clear-args", "Clear all arguments for stdio/package servers").option("--command <command>", "Executable command for stdio servers").option("--url <url>", "Remote endpoint URL").option("-y, --yes", "Skip interactive prompts").action(async (serverName, options) => {
+  try {
+    const cwd = process.cwd();
+    const isGlobal = Boolean(options.global);
+    const hasModifications = options.command !== void 0 || options.args !== void 0 || Boolean(options.clearArgs) || options.env !== void 0 || Boolean(options.clearEnv) || options.header !== void 0 || Boolean(options.clearHeaders) || options.url !== void 0 || options.transport !== void 0;
+    const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
+    if (hasModifications) {
+      if (options.url !== void 0 && options.command !== void 0) {
+        logger.error('Cannot specify both "--url" (remote) and "--command" (stdio) simultaneously.');
+        process.exitCode = 1;
+        return;
+      }
+      if (!serverName) {
+        logger.error('Missing required argument: "server-name" when passing modification flags.');
+        process.exitCode = 1;
+        return;
+      }
+      const targetGroup = requireTargetServerGroup(serverName, { global: isGlobal, cwd });
+      if (!targetGroup) {
+        return;
+      }
+      const isCurrentRemote = Boolean(targetGroup.config.url && targetGroup.config.url.length > 0);
+      const willBeRemote = options.url !== void 0 ? true : options.command !== void 0 ? false : isCurrentRemote;
+      if (willBeRemote) {
+        const ignoredStdioFlags = [];
+        if (options.env !== void 0) ignoredStdioFlags.push("--env");
+        if (options.clearEnv) ignoredStdioFlags.push("--clear-env");
+        if (options.args !== void 0) ignoredStdioFlags.push("--args");
+        if (options.clearArgs) ignoredStdioFlags.push("--clear-args");
+        if (ignoredStdioFlags.length > 0) {
+          const hint = options.url !== void 0 ? "When configuring a remote server, stdio flags are ignored." : "Use --command to switch to stdio mode.";
+          logger.warn(
+            `Server "${serverName}" is a remote server. The following stdio flags will be ignored: ${ignoredStdioFlags.join(", ")}. ${hint}`
+          );
+        }
+      } else {
+        const ignoredRemoteFlags = [];
+        if (options.header !== void 0) ignoredRemoteFlags.push("--header");
+        if (options.clearHeaders) ignoredRemoteFlags.push("--clear-headers");
+        if (options.transport !== void 0) ignoredRemoteFlags.push("--transport");
+        if (ignoredRemoteFlags.length > 0) {
+          const hint = options.command !== void 0 ? "When configuring a stdio server, remote flags are ignored." : "Use --url to switch to remote mode.";
+          logger.warn(
+            `Server "${serverName}" is a stdio server. The following remote flags will be ignored: ${ignoredRemoteFlags.join(", ")}. ${hint}`
+          );
+        }
+      }
+      const incomingDelta = {};
+      if (options.command !== void 0) {
+        incomingDelta.command = options.command;
+      }
+      if (options.clearArgs) {
+        incomingDelta.args = void 0;
+      }
+      if (options.args !== void 0) {
+        incomingDelta.args = options.args;
+      }
+      if (options.url !== void 0) {
+        incomingDelta.url = options.url;
+      }
+      if (options.transport !== void 0) {
+        incomingDelta.type = resolveTransport(options.transport);
+      }
+      if (options.clearEnv) {
+        incomingDelta.env = void 0;
+      }
+      if (options.env !== void 0) {
+        const parsedEnv = parseKeyValueList(options.env, "=");
+        const baseEnv = options.clearEnv ? {} : targetGroup.config.env ?? {};
+        incomingDelta.env = { ...baseEnv, ...parsedEnv };
+      }
+      if (options.clearHeaders) {
+        incomingDelta.headers = void 0;
+      }
+      if (options.header !== void 0) {
+        const parsedHeaders = parseKeyValueList(options.header, ":");
+        const baseHeaders = options.clearHeaders ? {} : targetGroup.config.headers ?? {};
+        incomingDelta.headers = { ...baseHeaders, ...parsedHeaders };
+      }
+      let targetAgents = targetGroup.agents;
+      if (options.agent !== void 0) {
+        const parsed = parseMcpAgentList(options.agent);
+        if (!parsed || parsed.length === 0) {
+          logger.error(`No valid agents recognized from: "${options.agent.join(", ")}".`);
+          process.exitCode = 1;
+          return;
+        }
+        targetAgents = parsed;
+      }
+      const updateResult = updateMcpServer({
+        serverName,
+        config: incomingDelta,
+        previousConfig: targetGroup.config,
+        agents: targetAgents,
+        global: isGlobal,
+        cwd
+      });
+      for (const item of updateResult.incompatible) {
+        logger.warn(`Skipping ${import_picocolors16.default.cyan(item.agent)}: ${item.reason}`);
+      }
+      const attemptedResults = updateResult.results.filter(
+        (r) => !updateResult.incompatible.some((i) => i.agent === r.agent)
+      );
+      if (attemptedResults.length === 0) {
+        const requestedTransport = updateResult.config.url ? updateResult.config.type ?? "http" : "stdio";
+        logger.error(
+          `None of the target agents support ${requestedTransport} transport. Update aborted.`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      logger.info(
+        `Updating ${import_picocolors16.default.bold(serverName)} across ${import_picocolors16.default.cyan(String(attemptedResults.length))} agent(s)...`
+      );
+      let allSuccess = true;
+      for (const res of attemptedResults) {
+        if (res.success) {
+          logger.success(`${import_picocolors16.default.cyan(res.agent)}: Successfully updated in ${import_picocolors16.default.dim(res.path)}`);
+          logCoHostedNotice("configured", res.coConfiguredAgents);
+        } else {
+          allSuccess = false;
+          logger.error(`${import_picocolors16.default.cyan(res.agent)}: Update failed - ${res.error}`);
+        }
+      }
+      if (!allSuccess) {
+        process.exitCode = 1;
+      }
+      return;
+    }
+    if (!isInteractive) {
+      if (!serverName) {
+        logger.error(
+          'Missing required argument: "server-name" for non-interactive manage command. Specify a server name or use interactive terminal.'
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const targetGroup = requireTargetServerGroup(serverName, { global: isGlobal, cwd });
+      if (!targetGroup) {
+        return;
+      }
+      displayServerDetails({
+        serverName,
+        config: targetGroup.config,
+        agents: targetGroup.agents,
+        global: isGlobal,
+        hasDivergence: targetGroup.hasDivergence
+      });
+      return;
+    }
+    await wizardManage({
+      global: options.global,
+      serverName
+    });
+  } catch (error) {
+    if (error && typeof error === "object" && "name" in error && error.name === "ExitPromptError") {
+      process.exit(0);
+    }
+    logger.error(toErrorMessage(error));
+    process.exitCode = 1;
+  }
+});
+
+// src/utils/format-agent-list.ts
+var formatAgentList = (agentList, emptyLabel = "(none)") => agentList.length === 0 ? emptyLabel : agentList.join(", ");
+
+// src/cli/add.ts
+var mcpAddCommand = new import_commander2.Command("add").description("Add an MCP server to coding agents").argument("[source]", "Remote URL, npm package, or command line").option("-a, --agent <agents...>", "Target specific agents (use '*' for all)").option("-g, --global", "Install to user-level config instead of project").option("-t, --transport <type>", "Transport type for remote servers (http or sse)").option("--header <header...>", "HTTP header (Key: Value), repeatable").option("--env <env...>", "Env var for stdio servers (KEY=VALUE), repeatable").option("--args <args...>", "CLI arguments for stdio/package servers").option("-n, --name <name>", "Server name override").option("-y, --yes", "Skip all prompts").option("--all", "Install to all supported agents").action(async (source, options) => {
   try {
     const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
     if (!source) {
@@ -2384,19 +3560,19 @@ var mcpAddCommand = new import_commander.Command("add").description("Add an MCP
       transport
     });
     if (resolvedTargets.agents.length === 0) {
-      const message = resolvedTargets.diagnostic ?? `No ${isGlobal ? "global" : "project"}-installed MCP agents detected. Pass ${import_picocolors11.default.cyan("-a <agent>")} (e.g. ${import_picocolors11.default.cyan("-a cursor")}) or ${import_picocolors11.default.cyan("--all")} to install.`;
+      const message = resolvedTargets.diagnostic ?? `No ${isGlobal ? "global" : "project"}-installed MCP agents detected. Pass ${import_picocolors17.default.cyan("-a <agent>")} (e.g. ${import_picocolors17.default.cyan("-a cursor")}) or ${import_picocolors17.default.cyan("--all")} to install.`;
       logger.warn(message);
       process.exitCode = 1;
       return;
     }
     if (resolvedTargets.isDetected) {
       logger.info(
-        `Detected ${isGlobal ? "global" : "project"} agents: ${import_picocolors11.default.cyan(formatAgentList(resolvedTargets.detected, "(none detected)"))}`
+        `Detected ${isGlobal ? "global" : "project"} agents: ${import_picocolors17.default.cyan(formatAgentList(resolvedTargets.detected, "(none detected)"))}`
       );
       if (resolvedTargets.incompatible.length > 0) {
         const skippedList = resolvedTargets.incompatible.map((item) => `${item.agent} (${item.reason})`).join(", ");
         logger.info(
-          `Skipping detected agents incompatible with ${transport}: ${import_picocolors11.default.yellow(skippedList)}`
+          `Skipping detected agents incompatible with ${transport}: ${import_picocolors17.default.yellow(skippedList)}`
         );
       }
     }
@@ -2413,13 +3589,14 @@ var mcpAddCommand = new import_commander.Command("add").description("Add an MCP
       env: parseKeyValueList(options.env, "=")
     });
     logger.info(
-      `Installing ${import_picocolors11.default.bold(result.serverName)} (${import_picocolors11.default.cyan(parsed.type)}) to ${import_picocolors11.default.cyan(String(result.results.length))} agent(s)`
+      `Installing ${import_picocolors17.default.bold(result.serverName)} (${import_picocolors17.default.cyan(parsed.type)}) to ${import_picocolors17.default.cyan(String(result.results.length))} agent(s)`
     );
     for (const record of result.results) {
       if (record.success) {
-        logger.success(`${import_picocolors11.default.cyan(record.agent)} ${import_picocolors11.default.dim(record.path)}`);
+        logger.success(`${import_picocolors17.default.cyan(record.agent)} ${import_picocolors17.default.dim(record.path)}`);
+        logCoHostedNotice("configured", record.coConfiguredAgents);
       } else {
-        logger.error(`${import_picocolors11.default.cyan(record.agent)}: ${record.error}`);
+        logger.error(`${import_picocolors17.default.cyan(record.agent)}: ${record.error}`);
       }
     }
     if (result.results.some((record) => !record.success)) process.exitCode = 1;
@@ -2430,9 +3607,9 @@ var mcpAddCommand = new import_commander.Command("add").description("Add an MCP
 });
 
 // src/cli/list.ts
-var import_commander2 = require("commander");
-var import_picocolors12 = __toESM(require("picocolors"), 1);
-var mcpListCommand = new import_commander2.Command("list").alias("ls").description("List installed MCP servers across agents").option("-g, --global", "List global configs instead of project").option("-a, --agent <agents...>", "Filter by specific agents").option("--json", "Output as JSON").action((options) => {
+var import_commander3 = require("commander");
+var import_picocolors18 = __toESM(require("picocolors"), 1);
+var mcpListCommand = new import_commander3.Command("list").alias("ls").description("List installed MCP servers across agents").option("-g, --global", "List global configs instead of project").option("-a, --agent <agents...>", "Filter by specific agents").option("--json", "Output as JSON").action((options) => {
   try {
     const entries = listInstalledMcpServers({
       global: Boolean(options.global),
@@ -2455,9 +3632,9 @@ var mcpListCommand = new import_commander2.Command("list").alias("ls").descripti
     }
     for (const [serverName, group] of grouped) {
       const agentLabels = group.map((record) => record.agent).join(", ");
-      console.log(`  ${import_picocolors12.default.bold(serverName)} ${import_picocolors12.default.dim(`[${agentLabels}]`)}`);
+      console.log(`  ${import_picocolors18.default.bold(serverName)} ${import_picocolors18.default.dim(`[${agentLabels}]`)}`);
       const firstPath = group[0]?.path;
-      if (firstPath) console.log(`    ${import_picocolors12.default.dim(firstPath)}`);
+      if (firstPath) console.log(`    ${import_picocolors18.default.dim(firstPath)}`);
     }
   } catch (error) {
     logger.error(toErrorMessage(error));
@@ -2466,9 +3643,9 @@ var mcpListCommand = new import_commander2.Command("list").alias("ls").descripti
 });
 
 // src/cli/remove.ts
-var import_commander3 = require("commander");
-var import_picocolors13 = __toESM(require("picocolors"), 1);
-var mcpRemoveCommand = new import_commander3.Command("remove").alias("rm").description("Remove an MCP server from agent configs").argument("[name]", "Server name").option("-g, --global", "Remove from global scope").option("-a, --agent <agents...>", "Filter by specific agents (use '*' for all)").option("-y, --yes", "Skip confirmation prompts").action(async (name, options) => {
+var import_commander4 = require("commander");
+var import_picocolors19 = __toESM(require("picocolors"), 1);
+var mcpRemoveCommand = new import_commander4.Command("remove").alias("rm").description("Remove an MCP server from agent configs").argument("[name]", "Server name").option("-g, --global", "Remove from global scope").option("-a, --agent <agents...>", "Filter by specific agents (use '*' for all)").option("-y, --yes", "Skip confirmation prompts").action(async (name, options) => {
   try {
     const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
     if (!name) {
@@ -2491,16 +3668,17 @@ var mcpRemoveCommand = new import_commander3.Command("remove").alias("rm").descr
       cwd: process.cwd()
     });
     if (results.length === 0) {
-      logger.warn(`No agent config contained ${import_picocolors13.default.bold(name)}`);
+      logger.warn(`No agent config contained ${import_picocolors19.default.bold(name)}`);
       return;
     }
     for (const record of results) {
       if (record.removed) {
         logger.success(
-          `${import_picocolors13.default.cyan(record.agent)} removed ${import_picocolors13.default.bold(name)} ${import_picocolors13.default.dim(record.path)}`
+          `${import_picocolors19.default.cyan(record.agent)} removed ${import_picocolors19.default.bold(name)} ${import_picocolors19.default.dim(record.path)}`
         );
+        logCoHostedNotice("affected", record.coAffectedAgents);
       } else {
-        logger.error(`${import_picocolors13.default.cyan(record.agent)}: ${record.error ?? "not found"}`);
+        logger.error(`${import_picocolors19.default.cyan(record.agent)}: ${record.error ?? "not found"}`);
       }
     }
   } catch (error) {
@@ -2510,12 +3688,13 @@ var mcpRemoveCommand = new import_commander3.Command("remove").alias("rm").descr
 });
 
 // src/cli.ts
-var VERSION = "0.1.0-beta.1";
+var VERSION = "0.1.0-beta.3";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
-var program = new import_commander4.Command().name("mcps").description("Install, list, and remove MCP servers across AI coding agents").version(VERSION, "-v, --version", "display the version number");
+var program = new import_commander5.Command().name("mcps").description("Install, list, and remove MCP servers across AI coding agents").version(VERSION, "-v, --version", "display the version number");
 program.addCommand(mcpAddCommand);
 program.addCommand(mcpListCommand);
+program.addCommand(mcpManageCommand);
 program.addCommand(mcpRemoveCommand);
 var main = async () => {
   if (process.argv.length <= 2 && process.stdin.isTTY) {