huaweicloud-devkit 1.1.3-next.1 → 1.1.3-next.2

package/.agents/plugins/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "huaweicloud-devkit",
   "interface": {
-    "displayName": "HuaweiCloud Devkit"
+    "displayName": "HuaweiCloud DevKit"
   },
   "plugins": [
     {

package/README.md

@@ -4,6 +4,7 @@
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![CI](https://github.com/huaweicloud/huaweicloud-devkit/actions/workflows/ci.yml/badge.svg)](https://github.com/huaweicloud/huaweicloud-devkit/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/huaweicloud-devkit)](https://www.npmjs.com/package/huaweicloud-devkit)
+[![Beta](https://img.shields.io/badge/beta-v1.1.3-orange)](https://github.com/huaweicloud/huaweicloud-devkit)
 
 **[中文](README.zh-CN.md) | English**
 
@@ -31,7 +32,18 @@ Supports OpenCode, Codex, CodeArts Agent, WorkBuddy, DeepSeek Harness (DSH), Off
 
 ## Quick Start
 
-> If `--target` is omitted, the installer auto-detects agents on your machine. When multiple agents are detected, **all of them** will be installed. Specify `--target` to control which agent receives the install.
+> If `--target` is omitted, the installer auto-detects agents on your machine:
+>
+> - **None detected**: interactive terminals ask what you want (install to one
+>   explicit target / install to all / wire up a generic MCP agent);
+>   non-interactive shells error out with the supported target list.
+> - **One detected**: installs directly to it.
+> - **Multiple detected**: interactive terminals show a multi-select chooser;
+>   non-interactive shells error and point at `--target <agent>` / `--target all`.
+>   For a one-shot full setup, run `npx --yes huaweicloud-devkit install --target all`
+>   (Codex is skipped when its CLI is missing).
+
+The commands below are global (they act on every agent):
 
 ```bash
 npx --yes huaweicloud-devkit version  # print CLI version and installed plugin versions per agent
@@ -51,7 +63,7 @@ npx --yes huaweicloud-devkit doctor --target opencode
 npx --yes huaweicloud-devkit status --target opencode
 npx --yes huaweicloud-devkit update --target opencode
 npx --yes huaweicloud-devkit uninstall --target opencode
-rm -rf ~/.npm/_npx/  # Linux/macOS only; Windows path TBD
+rm -rf ~/.npm/_npx/  # Linux/macOS; Windows: rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx
 ```
 
 ### Codex
@@ -211,7 +223,7 @@ npx --yes huaweicloud-devkit install --target openclaw
 npx --yes huaweicloud-devkit status --target openclaw
 npx --yes huaweicloud-devkit update --target openclaw
 npx --yes huaweicloud-devkit uninstall --target openclaw
-rm -rf ~/.npm/_npx/  # Linux/macOS only; Windows path TBD
+rm -rf ~/.npm/_npx/  # Linux/macOS; Windows: rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx
 ```
 
 ### AtomCode
@@ -256,7 +268,7 @@ If your agent supports `type: "remote"` (Streamable HTTP) instead of stdio, star
 npx --yes huaweicloud-devkit-mcp --transport remote
 ```
 
-It listens on `127.0.0.1:9528` by default (no conflict with the IACMCPServer port 9527). Then connect with a remote config (opencode example):
+It listens on `127.0.0.1:9528` by default. Then connect with a remote config (opencode example):
 
 ```jsonc
 {
@@ -312,7 +324,7 @@ npx --yes huaweicloud-devkit install --target all
 ### Update All Agents
 
 ```bash
-npx huaweicloud-devkit version
+npx --yes huaweicloud-devkit@latest version
 npx --yes huaweicloud-devkit@latest update --target all
 ```
 
@@ -322,7 +334,7 @@ locally cached older one.
 
 ## What It Does
 
-- **Guided cloud operations** — agents get step-by-step guidance for 20+ Huawei Cloud services (ECS, OBS, VPC, RDS, GaussDB, FunctionGraph, APIG, CCE, and more)
+- **Guided cloud operations** — agents get step-by-step guidance for 20+ commonly used Huawei Cloud services (ECS, OBS, VPC, RDS, GaussDB, FunctionGraph, APIG, CCE, and more)
 - **Safety-first execution** — all write operations require explicit user approval; credentials and secrets are automatically redacted from output
 - **Pre-execution risk checks** — public exposure, credential leaks, and destructive operations are caught before they run
 - **Regional awareness** — auto-discovers available regions and checks service availability before creating resources
@@ -332,6 +344,10 @@ locally cached older one.
 
 ECS, OBS, VPC, IAM, RDS, GaussDB, FunctionGraph, APIG, CCE, SMN/DMS, ModelArts, Cloud Eye, CTS, DEW, Billing, CBR, WAF/AAD, DDS/DCS, Deployment, and Getting Started guides.
 
+> Above is the pre-wired guidance list; the remaining 200+ Huawei Cloud services
+> are still reachable via KooCLI / API / SDK routing (see capability-discovery
+> and cli-and-auth meta-skills).
+
 ## Documentation
 
 - [Architecture](docs/architecture.md)

package/README.zh-CN.md

@@ -1,9 +1,10 @@
 # HuaweiCloud DevKit
 
-[![参与讨论](https://img.shields.io/badge/参与讨论-Join%20the%20discussion-blue)](https://github.com/huaweicloud/huaweicloud-devkit/discussions)
+[![Discussions](https://img.shields.io/badge/Discussions-Join%20the%20discussion-blue)](https://github.com/huaweicloud/huaweicloud-devkit/discussions)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![CI](https://github.com/huaweicloud/huaweicloud-devkit/actions/workflows/ci.yml/badge.svg)](https://github.com/huaweicloud/huaweicloud-devkit/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/huaweicloud-devkit)](https://www.npmjs.com/package/huaweicloud-devkit)
+[![Beta](https://img.shields.io/badge/beta-v1.1.3-orange)](https://github.com/huaweicloud/huaweicloud-devkit)
 
 **中文 | [English](README.md)**
 
@@ -31,7 +32,14 @@
 
 ## 快速开始
 
-> 省略 `--target` 时，安装器会自动检测机器上的 agent，检测到多个时**全部安装**。建议始终指定 `--target` 以明确安装目标。
+> 省略 `--target` 时，安装器会自动检测机器上的 agent：
+>
+> - **未检测到**：交互终端会询问你如何继续（指定 target 安装 / 全部安装 / 接入通用 MCP agent）；非交互终端报错并列出支持列表。
+> - **检测到单个**：直接安装到该 agent。
+> - **检测到多个**：交互终端弹出多选；非交互终端报错并提示 `--target <agent>` 或 `--target all`。
+>   需要一步全量安装时执行 `npx --yes huaweicloud-devkit install --target all`（Codex 缺少 CLI 时跳过）。
+
+以下为全局命令（一次性作用于所有 agent）：
 
 ```bash
 npx --yes huaweicloud-devkit version  # 查看 CLI 版本和各 agent 已安装的插件版本
@@ -51,7 +59,7 @@ npx --yes huaweicloud-devkit doctor --target opencode
 npx --yes huaweicloud-devkit status --target opencode
 npx --yes huaweicloud-devkit update --target opencode
 npx --yes huaweicloud-devkit uninstall --target opencode
-rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows 路径待确认
+rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows：rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx
 ```
 
 ### Codex
@@ -211,7 +219,7 @@ npx --yes huaweicloud-devkit install --target openclaw
 npx --yes huaweicloud-devkit status --target openclaw
 npx --yes huaweicloud-devkit update --target openclaw
 npx --yes huaweicloud-devkit uninstall --target openclaw
-rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows 路径待确认
+rm -rf ~/.npm/_npx/  # 仅 Linux/macOS；Windows：rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx
 ```
 
 ### AtomCode
@@ -256,7 +264,7 @@ npx --yes huaweicloud-devkit uninstall --target atomcode
 npx --yes huaweicloud-devkit-mcp --transport remote
 ```
 
-默认监听 `127.0.0.1:9528`（与预置的 IACMCPServer 端口 9527 不冲突）。随后以远程方式连接（以 opencode 为例）：
+默认监听 `127.0.0.1:9528`。随后以远程方式连接（以 opencode 为例）：
 
 ```jsonc
 {
@@ -312,7 +320,7 @@ npx --yes huaweicloud-devkit install --target all
 ### 更新所有 Agent
 
 ```bash
-npx huaweicloud-devkit version
+npx --yes huaweicloud-devkit@latest version
 npx --yes huaweicloud-devkit@latest update --target all
 ```
 
@@ -320,7 +328,7 @@ npx --yes huaweicloud-devkit@latest update --target all
 
 ## 功能特性
 
-- **引导式云操作** — Agent 获得 20+ 华为云服务的分步操作指引（ECS、OBS、VPC、RDS、GaussDB、FunctionGraph、APIG、CCE 等）
+- **引导式云操作** — Agent 获得 20+ 常用华为云服务的分步操作指引（ECS、OBS、VPC、RDS、GaussDB、FunctionGraph、APIG、CCE 等）
 - **安全优先执行** — 所有写操作需用户明确批准；凭证和密钥自动脱敏
 - **执行前风险检查** — 公网暴露、凭证泄露、破坏性操作在执行前即被拦截
 - **区域感知** — 自动发现可用区域，创建资源前检查服务可用性
@@ -330,6 +338,8 @@ npx --yes huaweicloud-devkit@latest update --target all
 
 ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、ModelArts、Cloud Eye、CTS、DEW、Billing、CBR、WAF/AAD、DDS/DCS、Deployment，以及入门指南。
 
+> 以上为预置指引的服务列表；其余 200+ 华为云服务仍可通过 KooCLI / API / SDK 路由调用（见 capability-discovery 与 cli-and-auth 元技能）。
+
 ## 文档
 
 - [架构](docs/architecture.md)

package/integrations/opencode/commands/huaweicloud-doctor.md

@@ -2,7 +2,7 @@
 description: Self-check Huawei Cloud DevKit readiness — hcloud, MCP, skills, auth.
 ---
 
-Use HuaweiCloud Devkit tools and skills to perform a comprehensive readiness check:
+Use HuaweiCloud DevKit tools and skills to perform a comprehensive readiness check:
 
 1. Check if KooCLI `hcloud` is installed: `huaweicloud_check_cli`. If not, guide user to install.
 2. Check if hcloud has active credentials: `hcloud configure list` (redacted).

package/integrations/opencode/skills/huaweicloud-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: huaweicloud-core
-description: OpenCode entry skill for HuaweiCloud Devkit. Use when a developer asks OpenCode to use Huawei Cloud Skills, KooCLI, APIs, SDKs, future MCP tools, or low-priority Terraform guidance.
+description: OpenCode entry skill for HuaweiCloud DevKit. Use when a developer asks OpenCode to use Huawei Cloud Skills, KooCLI, APIs, SDKs, future MCP tools, or low-priority Terraform guidance.
 ---
 
 # Huawei Cloud Core For OpenCode

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "huaweicloud-devkit",
   "mcpName": "io.github.huaweicloud/huaweicloud-devkit",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "kooCliVersion": "7.2.12",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "type": "module",
@@ -33,10 +33,11 @@
     "test": "node --test \"test/*.test.mjs\"",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\"",
+    "lint:md": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.git\" \"#test/**\" \"#docs/**\" \"#.superpowers/**\"",
     "lint:js": "eslint .",
     "lint": "npm run lint:md && npm run lint:js",
-    "validate": "node ./scripts/validate-package.mjs",
+    "validate": "node ./scripts/validate-package.mjs && node ./scripts/sync-readme-badge.mjs",
+    "badge:sync": "node ./scripts/sync-readme-badge.mjs --write",
     "pack:verify": "node ./scripts/pack-verify.mjs",
     "postinstall": "node ./bin/dsh-postinstall.cjs"
   },

package/plugins/huaweicloud-core/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "interface": {
-    "displayName": "HuaweiCloud Devkit",
-    "shortDescription": "HuaweiCloud Devkit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
-    "longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
+    "displayName": "HuaweiCloud DevKit",
+    "shortDescription": "HuaweiCloud DevKit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
+    "longDescription": "HuaweiCloud DevKit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
     "developerName": "HuaweiCloud Mate",
     "category": "Cloud",
     "capabilities": ["Read", "Interactive"],
@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "interface": {
-    "shortDescription": "HuaweiCloud Devkit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
+    "shortDescription": "HuaweiCloud DevKit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
     "developerName": "HuaweiCloud Mate",
     "capabilities": ["Read", "Interactive"],
     "brandColor": "#C7000B",
@@ -13,14 +13,14 @@
       "Check my Huawei Cloud CLI setup safely.",
       "Plan this Huawei Cloud API or SDK task."
     ],
-    "longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
+    "longDescription": "HuaweiCloud DevKit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
     "websiteURL": "https://github.com/huaweicloud/HuaweiCloud-Devkit",
-    "displayName": "HuaweiCloud Devkit"
+    "displayName": "HuaweiCloud DevKit"
   },
   "mcpServers": "./.mcp.json",
   "description": "Agent toolkit that helps coding agents use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities safely and accurately.",
   "skills": "./skills/",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "interface": {
-    "displayName": "HuaweiCloud Devkit",
-    "shortDescription": "HuaweiCloud Devkit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
-    "longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
+    "displayName": "HuaweiCloud DevKit",
+    "shortDescription": "HuaweiCloud DevKit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
+    "longDescription": "HuaweiCloud DevKit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
     "developerName": "HuaweiCloud Mate",
     "category": "Cloud",
     "capabilities": ["Read", "Interactive"],
@@ -17,7 +17,7 @@
   "mcpServers": "./.mcp.json",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "skills": "./skills/",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "author": {
     "name": "HuaweiCloud Mate",
     "url": "https://github.com/huaweicloud"

package/plugins/huaweicloud-core/.hermes-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",
@@ -13,9 +13,9 @@
   "skills": "./skills/",
   "mcpServers": "./.mcp.json",
   "interface": {
-    "displayName": "HuaweiCloud Devkit",
-    "shortDescription": "HuaweiCloud Devkit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
-    "longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
+    "displayName": "HuaweiCloud DevKit",
+    "shortDescription": "HuaweiCloud DevKit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
+    "longDescription": "HuaweiCloud DevKit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
     "developerName": "HuaweiCloud Mate",
     "category": "Cloud",
     "capabilities": ["Read", "Interactive"],

package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "huaweicloud-devkit",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "description": "Guide coding agents to use Huawei Cloud Skills, KooCLI, APIs, SDKs, and future MCP capabilities with safer execution and less context.",
   "author": {
     "name": "HuaweiCloud Mate",
@@ -13,9 +13,9 @@
   "skills": "./skills/",
   "mcpServers": "./.mcp.json",
   "interface": {
-    "displayName": "HuaweiCloud Devkit",
-    "shortDescription": "HuaweiCloud Devkit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
-    "longDescription": "HuaweiCloud Devkit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
+    "displayName": "HuaweiCloud DevKit",
+    "shortDescription": "HuaweiCloud DevKit - Huawei Cloud guidance, CLI/API/SDK routing, MCP tools, and safety for coding agents.",
+    "longDescription": "HuaweiCloud DevKit helps coding agents choose and use Huawei Cloud Skills, KooCLI, APIs, SDKs, and MCP tools with less context, safer command execution, and more accurate cloud implementation decisions.",
     "developerName": "HuaweiCloud Mate",
     "category": "Cloud",
     "capabilities": ["Read", "Interactive"],

package/plugins/huaweicloud-core/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "name": "huaweicloud-devkit",
   "id": "huaweicloud-devkit",
   "displayName": "HuaweiCloud DevKit",
-  "version": "1.1.3-next.1",
+  "version": "1.1.3-next.2",
   "family": "bundle-plugin",
   "bundleFormat": "codex",
   "description": "Guide coding agents to use Huawei Cloud safely — KooCLI, APIs, SDKs, 28 MCP tools, skills, and safety guardrails.",

package/plugins/huaweicloud-core/src/setup-cli.mjs

@@ -1047,7 +1047,7 @@ async function installCodexDesktop() {
 
   // Register in personal marketplace (Codex discovers plugins from ~/.agents/plugins/marketplace.json)
   ensureCodexMarketplaceEntry();
-  console.log('  \x1b[33m请到插件 → 个人 → HuaweiCloud Devkit → 安装\x1b[0m');
+  console.log('  \x1b[33m请到插件 → 个人 → HuaweiCloud DevKit → 安装\x1b[0m');
 
   // Clean up old install locations from pre-marketplace era
   removeIfExists(join(homedir(), '.agents', 'skills'));
@@ -3009,7 +3009,7 @@ function opencodeStatus() {
   }
 }
 
-function autoDetectTarget() {
+function detectAgents() {
   const checks = [
     ['opencode', () => existsSync(join(homedir(), '.config', 'opencode'))],
     ['codex-desktop', () => existsSync(join(homedir(), '.codex'))],
@@ -3028,7 +3028,11 @@ function autoDetectTarget() {
     ['openclaw', () => existsSync(join(homedir(), '.openclaw'))],
     ['atomcode', () => existsSync(atomcodeHome())],
   ];
-  const detected = checks.filter(([, check]) => check()).map(([name]) => name);
+  return checks.filter(([, check]) => check()).map(([name]) => name);
+}
+
+function autoDetectTarget() {
+  const detected = detectAgents();
   if (detected.length === 0) {
     console.error('No supported agent detected.');
     console.error(`Supported: ${SUPPORTED_AGENT_TARGETS.join(', ')} (or "all")`);
@@ -3039,6 +3043,208 @@ function autoDetectTarget() {
   return 'all';
 }
 
+const AGENT_LABELS = {
+  opencode: 'OpenCode',
+  'codex-desktop': 'Codex Desktop',
+  codearts: 'CodeArts',
+  'codearts-work': 'CodeArts Work',
+  workbuddy: 'WorkBuddy',
+  dsh: 'DSH',
+  officeace: 'OfficeAce',
+  hermes: 'Hermes',
+  openclaw: 'OpenClaw',
+  atomcode: 'AtomCode',
+};
+
+function promptSelectAgents(detected) {
+  if (!process.stdin.isTTY) {
+    console.error(
+      `Multiple agents detected (${detected.join(', ')}). Cannot prompt in a non-interactive shell — ` +
+        'specify `--target <agent>` or `--target all`.',
+    );
+    return Promise.resolve(null);
+  }
+  const question = [
+    'Multiple agents detected. Select which to install (multi-select):',
+    ...detected.map((name, i) => `  ${i + 1}) ${AGENT_LABELS[name] || name}`),
+    'Enter numbers separated by commas/spaces, "all" for every detected, Enter to install all detected, or "0" to cancel: ',
+  ].join('\n');
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (a) => {
+      rl.close();
+      const answer = (a || '').trim().toLowerCase();
+      if (answer === '0' || answer === 'n' || answer === 'no' || answer === 'q') {
+        resolve(null);
+        return;
+      }
+      if (answer === '' || answer === 'all') {
+        resolve(detected.slice());
+        return;
+      }
+      const parts = answer.split(/[\s,，]+/).filter(Boolean);
+      const indices = new Set();
+      for (const part of parts) {
+        const n = Number(part);
+        if (Number.isSafeInteger(n) && n >= 1 && n <= detected.length) {
+          indices.add(n - 1);
+        } else {
+          console.error(`Invalid selection: "${part}". Installing all detected.`);
+          resolve(detected.slice());
+          return;
+        }
+      }
+      resolve([...indices].map((i) => detected[i]));
+    });
+  });
+}
+
+const MCP_ENTRY = {
+  command: 'npx',
+  args: ['-y', '-p', 'huaweicloud-devkit', 'huaweicloud-devkit-mcp'],
+};
+
+function promptZeroDetect() {
+  if (!process.stdin.isTTY) {
+    console.error('No supported agent detected.');
+    console.error(`Supported: ${SUPPORTED_AGENT_TARGETS.join(', ')} (or "all")`);
+    console.error('Use --target <agent> to specify.');
+    return Promise.resolve({ abort: true });
+  }
+  const question = [
+    'No supported agent detected.',
+    'What would you like to do?',
+    '  1) Install to a specific agent (e.g. codex)',
+    '  2) Install to all supported agents (--target all)',
+    '  3) Wire up a generic MCP agent (Claude Code / Cursor / custom MCP client)',
+    '  0) Exit',
+    'Enter choice: ',
+  ].join('\n');
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = () => {
+      rl.question(question, (a) => {
+        const answer = (a || '').trim().toLowerCase();
+        if (answer === '1') {
+          rl.question('Enter agent target (e.g. codex): ', (t) => {
+            const val = (t || '').trim().toLowerCase();
+            rl.close();
+            if (val === 'all' || SUPPORTED_AGENT_TARGETS.includes(val)) {
+              resolve({ explicit: true, target: val });
+            } else {
+              console.error(`Unknown target: ${val}`);
+              console.error(`Supported: ${SUPPORTED_AGENT_TARGETS.join(', ')} (or "all")`);
+              resolve({ abort: true });
+            }
+          });
+          return;
+        }
+        if (answer === '2') {
+          rl.close();
+          resolve({ explicit: true, target: 'all' });
+          return;
+        }
+        if (answer === '3') {
+          rl.close();
+          resolve({ mcp: true });
+          return;
+        }
+        if (answer === '' || answer === '0' || answer === 'n' || answer === 'no' || answer === 'q') {
+          rl.close();
+          resolve({ abort: true });
+          return;
+        }
+        console.error(`Invalid choice: "${answer}"`);
+        ask();
+      });
+    };
+    ask();
+  });
+}
+
+function printMCPConfigSnippet(reason) {
+  console.log(`  ${reason}`);
+  console.log('  Add this to your agent MCP config (stdio):');
+  const snippet = JSON.stringify({ mcpServers: { 'huaweicloud-devkit': MCP_ENTRY } }, null, 2)
+    .split('\n')
+    .map((line) => `    ${line}`)
+    .join('\n');
+  console.log(snippet);
+  console.log('  Or run the remote server and use a remote (Streamable HTTP) config:');
+  console.log('    npx --yes huaweicloud-devkit-mcp --transport remote   # listens on 127.0.0.1:9528');
+  console.log('  See README → "Other Agents" for details.');
+}
+
+function configureMCPAgent(targetFile, agentLabel) {
+  let config = {};
+  let existed = false;
+  if (existsSync(targetFile)) {
+    existed = true;
+    try {
+      config = JSON.parse(readFileSync(targetFile, 'utf8'));
+    } catch {
+      console.error(`  [${agentLabel}] ${targetFile} is not valid JSON; leaving it untouched.`);
+      return false;
+    }
+  }
+  config.mcpServers = config.mcpServers || {};
+  if (config.mcpServers['huaweicloud-devkit']) {
+    console.log(`  [${agentLabel}] mcpServers.huaweicloud-devkit already configured; skipping.`);
+    return true;
+  }
+  if (existed) copyFileSync(targetFile, `${targetFile}.bak`);
+  config.mcpServers['huaweicloud-devkit'] = { ...MCP_ENTRY };
+  mkdirSync(dirname(targetFile), { recursive: true });
+  writeFileSync(targetFile, JSON.stringify(config, null, 2), 'utf8');
+  console.log(`  [${agentLabel}] MCP server configured in ${targetFile}. Restart the session to apply.`);
+  return true;
+}
+
+function configureGenericMCP() {
+  console.log('Configuring a generic MCP agent (MCP tools only; skills/hooks are not installed)...');
+  const targets = [];
+  const claudeFile = process.env.CLAUDE_CONFIG_DIR
+    ? join(process.env.CLAUDE_CONFIG_DIR, '.claude.json')
+    : join(homedir(), '.claude.json');
+  if (existsSync(claudeFile)) targets.push(['Claude Code', claudeFile]);
+  const cursorFile = join(homedir(), '.cursor', 'mcp.json');
+  if (existsSync(cursorFile) || existsSync(join(homedir(), '.cursor'))) {
+    targets.push(['Cursor', cursorFile]);
+  }
+
+  if (targets.length === 0) {
+    printMCPConfigSnippet('No known MCP agent detected; here is a config snippet you can paste:');
+    return false;
+  }
+  let anyConfigured = false;
+  for (const [label, file] of targets) {
+    if (configureMCPAgent(file, label)) anyConfigured = true;
+  }
+  if (!anyConfigured) {
+    console.log('  Nothing to configure for the detected MCP agents.');
+  }
+  return anyConfigured;
+}
+
+async function resolveInstallTarget() {
+  const idx = process.argv.indexOf('--target');
+  if (idx >= 0) {
+    const val = (process.argv[idx + 1] || '').toLowerCase();
+    if (val === 'all' || SUPPORTED_AGENT_TARGETS.includes(val)) {
+      return { explicit: true, target: val };
+    }
+    console.error(`Unknown target: ${val}`);
+    console.error(`Supported: ${SUPPORTED_AGENT_TARGETS.join(', ')} (or "all")`);
+    process.exit(1);
+  }
+  const detected = detectAgents();
+  if (detected.length === 1) return { explicit: true, target: detected[0] };
+  if (detected.length === 0) return promptZeroDetect();
+  const chosen = await promptSelectAgents(detected);
+  if (!chosen) return { abort: true };
+  return { explicit: false, subset: chosen };
+}
+
 function parseTarget() {
   const idx = process.argv.indexOf('--target');
   if (idx < 0) return autoDetectTarget();
@@ -3084,13 +3290,37 @@ function writeInstallMarker(target) {
 }
 
 async function cmdInstall() {
-  const target = parseTarget();
   console.log(BANNER);
-  console.log(`Installing HuaweiCloud DevKit${target !== 'opencode' ? ` for ${target}` : ''}...\n`);
+  const plan = await resolveInstallTarget();
+  if (plan.abort) {
+    process.exitCode = 1;
+    return;
+  }
+  if (plan.mcp) {
+    const ok = configureGenericMCP();
+    process.exitCode = ok ? 0 : 1;
+    return;
+  }
+  const hasExplicitTarget = plan.explicit;
+  const target = plan.explicit ? plan.target : null;
+  const selected = new Set(plan.explicit ? [] : plan.subset);
+
+  if (hasExplicitTarget) {
+    console.log(`Installing HuaweiCloud DevKit for ${target}...\n`);
+  } else {
+    console.log(`Installing HuaweiCloud DevKit to ${[...selected].join(', ')}...\n`);
+  }
+
   checkNode();
   checkForUpdate();
   const installFailures = [];
 
+  function shouldInstall(name) {
+    if (name === 'codex') return hasExplicitTarget && (target === 'codex' || target === 'all');
+    if (hasExplicitTarget) return target === name || target === 'all';
+    return selected.has(name);
+  }
+
   async function runInstallStep(stepTarget, title, fn) {
     console.log(title);
     try {
@@ -3108,37 +3338,37 @@ async function cmdInstall() {
     }
   }
 
-  if (target === 'opencode' || target === 'all') {
+  if (shouldInstall('opencode')) {
     await runInstallStep('opencode', '[OpenCode]', installOpenCode);
   }
-  if (target === 'codex-desktop' || target === 'all') {
+  if (shouldInstall('codex-desktop')) {
     await runInstallStep('codex-desktop', '\n[Codex Desktop]', installCodexDesktop);
   }
-  if (target === 'codearts' || target === 'all') {
+  if (shouldInstall('codearts')) {
     await runInstallStep('codearts', '\n[CodeArts]', installCodeArts);
   }
-  if (target === 'codearts-work' || target === 'all') {
+  if (shouldInstall('codearts-work')) {
     await runInstallStep('codearts-work', '\n[CodeArts Work]', installCodeArtsWork);
   }
-  if (target === 'workbuddy' || target === 'all') {
+  if (shouldInstall('workbuddy')) {
     await runInstallStep('workbuddy', '\n[WorkBuddy]', installWorkBuddy);
   }
-  if (target === 'dsh' || target === 'all') {
+  if (shouldInstall('dsh')) {
     await runInstallStep('dsh', '\n[DSH]', installDsh);
   }
-  if (target === 'officeace' || target === 'all') {
+  if (shouldInstall('officeace')) {
     await runInstallStep('officeace', '\n[OfficeAce]', installOfficeAce);
   }
-  if (target === 'hermes' || target === 'all') {
+  if (shouldInstall('hermes')) {
     await runInstallStep('hermes', '\n[Hermes Agent]', installHermes);
   }
-  if (target === 'openclaw' || target === 'all') {
+  if (shouldInstall('openclaw')) {
     await runInstallStep('openclaw', '\n[OpenClaw]', installOpenClaw);
   }
-  if (target === 'atomcode' || target === 'all') {
+  if (shouldInstall('atomcode')) {
     await runInstallStep('atomcode', '\n[AtomCode]', installAtomCode);
   }
-  if (target === 'codex' || target === 'all') {
+  if (shouldInstall('codex')) {
     await runInstallStep('codex', '\n[Codex]', () => {
       if (!hasCodexCLI()) {
         if (target === 'codex') {
@@ -4068,6 +4298,10 @@ async function cmdReinstall() {
 let confirmed = false;
 async function confirm(msg) {
   if (confirmed) return true;
+  if (!process.stdin.isTTY) {
+    console.log('Non-interactive shell: skipping confirmation (declined).');
+    return false;
+  }
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((ok) => {
     rl.question(`${msg} [y/N] `, (a) => {