npm - agentquad - Versions diffs - 0.4.0 → 0.4.3 - Mend

agentquad 0.4.0 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/dist-web/assets/{index-Wl5vjZ8T.css → index-CEiuiF0m.css} +1 -1
package/dist-web/assets/{index-oovKASxm.js → index-nkG0O5n8.js} +246 -231
package/dist-web/index.html +2 -2
package/package.json +1 -1
package/src/agent-installer-dispatcher.js +87 -0
package/src/agent-installer-shared.js +101 -0
package/src/claude-agent-installer.js +135 -0
package/src/cli.js +208 -0
package/src/codex-agent-installer.js +165 -0
package/src/config.js +6 -0
package/src/cursor-agent-installer.js +128 -0
package/src/lark-api-client.js +59 -4
package/src/lark-bot.js +7 -7
package/src/lark-post.js +285 -0
package/src/mcp/server.js +34 -21
package/src/mcp/tools/openclaw/index.js +6 -0
package/src/openclaw-hook.js +1 -1
package/src/permission-prompt.js +188 -0
package/src/pty.js +35 -6
package/src/routes/ai-terminal.js +147 -15
package/src/server.js +4 -3
package/src/templates/agent-skills/agentquad-child.cursor.mdc +26 -0
package/src/templates/agent-skills/agentquad-child.skill.md +29 -0

package/dist-web/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="icon" type="image/png" href="/favicon.png" />
     <title>AgentQuad</title>
-    <script type="module" crossorigin src="/assets/index-oovKASxm.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-Wl5vjZ8T.css">
+    <script type="module" crossorigin src="/assets/index-nkG0O5n8.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CEiuiF0m.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agentquad",
-  "version": "0.4.0",
+  "version": "0.4.3",
   "description": "AgentQuad — local four-quadrant AI task scheduler with embedded Claude Code / Codex terminals",
   "license": "MIT",
   "author": "LIUZHENHUA521",

package/src/agent-installer-dispatcher.js ADDED Viewed

@@ -0,0 +1,87 @@
+/**
+ * 三家 agent installer 统一分发：
+ *   - install / uninstall / inspect / preview
+ *   - 单个 target 失败不阻断其它
+ *   - overrides 注入测试用路径
+ */
+import * as claudeInst from './claude-agent-installer.js'
+import * as codexInst from './codex-agent-installer.js'
+import * as cursorInst from './cursor-agent-installer.js'
+const TARGETS = ['claude', 'codex', 'cursor']
+function targetMod(name) {
+  if (name === 'claude') return claudeInst
+  if (name === 'codex') return codexInst
+  if (name === 'cursor') return cursorInst
+  throw new Error('unknown_target:' + name)
+}
+function pickTargets(only) {
+  if (!only) return TARGETS
+  return TARGETS.filter(t => only.includes(t))
+}
+export function installAllAgents({ port, version, only = null, overrides = {} } = {}) {
+  const results = {}
+  const failed = []
+  for (const t of pickTargets(only)) {
+    const args = { port, version, ...(overrides[t] || {}) }
+    try {
+      results[t] = targetMod(t).installAgent(args)
+    } catch (e) {
+      results[t] = { ok: false, error: e?.message || String(e) }
+      failed.push(t)
+    }
+  }
+  return { results, summary: { failed } }
+}
+export function uninstallAllAgents({ only = null, overrides = {} } = {}) {
+  const results = {}
+  const failed = []
+  for (const t of pickTargets(only)) {
+    try {
+      results[t] = targetMod(t).uninstallAgent(overrides[t] || {})
+    } catch (e) {
+      results[t] = { ok: false, error: e?.message || String(e) }
+      failed.push(t)
+    }
+  }
+  return { results, summary: { failed } }
+}
+export function inspectAllAgents({ expectedPort = null, only = null, overrides = {} } = {}) {
+  const results = {}
+  const failed = []
+  for (const t of pickTargets(only)) {
+    try {
+      results[t] = targetMod(t).inspectAgent({ expectedPort, ...(overrides[t] || {}) })
+    } catch (e) {
+      results[t] = { target: t, mcpRegistered: false, skillPresent: false, drift: false, error: e?.message || String(e) }
+      failed.push(t)
+    }
+  }
+  return { results, summary: { failed } }
+}
+export function previewAllAgents({ port, version, only = null, overrides = {} } = {}) {
+  // 干跑：先 inspect 看现状，再算出"如果 install 会做什么"
+  const results = {}
+  const failed = []
+  for (const t of pickTargets(only)) {
+    try {
+      const ins = targetMod(t).inspectAgent({ expectedPort: port, ...(overrides[t] || {}) })
+      const changes = []
+      if (!ins.mcpRegistered) changes.push('mcp_registered')
+      else if (ins.drift) changes.push('mcp_port_update')
+      else if (ins.version !== version) changes.push('mcp_version_update')
+      if (!ins.skillPresent) changes.push(t === 'cursor' ? 'rule_installed' : 'skill_installed')
+      results[t] = { changes }
+    } catch (e) {
+      results[t] = { changes: [], error: e?.message || String(e) }
+      failed.push(t)
+    }
+  }
+  return { results, summary: { failed } }
+}

package/src/agent-installer-shared.js ADDED Viewed

@@ -0,0 +1,101 @@
+/**
+ * 三家 agent installer 共享工具：
+ *   - marker 元数据（_agentquadManaged 旁路键）
+ *   - atomic JSON 写入（O_EXCL + rename）
+ *   - 运行时 MCP 配置文件读写（spec C 方案）
+ *
+ * Marker 约定：JSON 文件里和 mcpServers.agentquad 同级放：
+ *   { _agentquadManaged: { version, port, generatedAt } }
+ * 不引入独立 lockfile，跟现有 hook installer 风格保持一致。
+ */
+import { existsSync, mkdirSync, writeFileSync, renameSync, unlinkSync, readdirSync, statSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { randomBytes } from 'node:crypto'
+export function buildMarker({ version, port }) {
+  return {
+    version: String(version || ''),
+    port: Number(port) || 0,
+    generatedAt: new Date().toISOString(),
+  }
+}
+export function isAgentquadManaged(entry) {
+  if (!entry || typeof entry !== 'object') return false
+  const m = entry._agentquadManaged
+  return !!(m && typeof m === 'object' && typeof m.version === 'string')
+}
+/**
+ * Atomic generic file write via tmp + rename. Used by writeJsonAtomic and TOML callers.
+ */
+export function writeFileAtomic(targetPath, content) {
+  mkdirSync(dirname(targetPath), { recursive: true })
+  const tmp = `${targetPath}.tmp.${randomBytes(4).toString('hex')}`
+  writeFileSync(tmp, content, { encoding: 'utf8' })
+  renameSync(tmp, targetPath)
+}
+/**
+ * Atomic JSON 写入。
+ * 通过 `<target>.tmp.<rand>` 中转 + rename，保证不出现部分写入。
+ */
+export function writeJsonAtomic(targetPath, value) {
+  writeFileAtomic(targetPath, JSON.stringify(value, null, 2) + '\n')
+}
+/**
+ * 运行时 MCP 配置文件（C 方案）。
+ *   - tool=claude → JSON 格式（claude --mcp-config 接受 JSON）
+ *   - tool=codex  → TOML 格式
+ * 路径：<runtimeDir>/mcp-<sessionId>.{json|toml}
+ */
+export function writeRuntimeMcpConfig({ runtimeDir, sessionId, port, tool }) {
+  mkdirSync(runtimeDir, { recursive: true })
+  const url = `http://127.0.0.1:${port}/mcp`
+  if (tool === 'codex') {
+    const path = join(runtimeDir, `mcp-${sessionId}.toml`)
+    const toml = `# agentquad runtime mcp config — auto generated, do not edit\n` +
+      `[mcp_servers.agentquad]\n` +
+      `url = "${url}"\n` +
+      `transport = "http"\n`
+    writeFileAtomic(path, toml)
+    return { path, format: 'toml' }
+  }
+  // default: claude json format
+  const path = join(runtimeDir, `mcp-${sessionId}.json`)
+  writeJsonAtomic(path, {
+    mcpServers: {
+      agentquad: {
+        type: 'http',
+        url,
+      },
+    },
+  })
+  return { path, format: 'json' }
+}
+export function cleanupRuntimeMcpConfig({ runtimeDir, sessionId }) {
+  for (const ext of ['json', 'toml']) {
+    const p = join(runtimeDir, `mcp-${sessionId}.${ext}`)
+    try { if (existsSync(p)) unlinkSync(p) } catch { /* swallow */ }
+  }
+}
+/**
+ * 给 doctor / dispatcher 用：扫 runtimeDir，列出过去 maxAgeMs 没刷新的孤儿。
+ */
+export function listStaleRuntimeConfigs({ runtimeDir, maxAgeMs = 24 * 3600 * 1000 } = {}) {
+  if (!existsSync(runtimeDir)) return []
+  const now = Date.now()
+  return readdirSync(runtimeDir)
+    .filter(n => /^mcp-.*\.(json|toml)$/.test(n))
+    .map(n => {
+      try {
+        return { name: n, path: join(runtimeDir, n), age: now - statSync(join(runtimeDir, n)).mtimeMs }
+      } catch {
+        return null
+      }
+    })
+    .filter(x => x && x.age > maxAgeMs)
+}

package/src/claude-agent-installer.js ADDED Viewed

@@ -0,0 +1,135 @@
+/**
+ * Claude Code agent installer：
+ *   - 写 ~/.claude.json 的 mcpServers.agentquad（带 _agentquadManaged 旁路 marker）
+ *   - 装 ~/.claude/skills/agentquad-child/SKILL.md
+ *
+ * 跟 src/openclaw-hook-installer.js 风格保持一致 —— 都是改 ~/.claude.json。
+ */
+import { existsSync, mkdirSync, readFileSync, copyFileSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+import { buildMarker, isAgentquadManaged, writeJsonAtomic } from './agent-installer-shared.js'
+const SKILL_NAME = 'agentquad-child'
+function defaultClaudeJsonPath() {
+  return join(homedir(), '.claude.json')
+}
+function defaultSkillsDir() {
+  return join(homedir(), '.claude', 'skills')
+}
+function defaultSkillTemplatePath() {
+  return fileURLToPath(new URL('./templates/agent-skills/agentquad-child.skill.md', import.meta.url))
+}
+function readClaudeJson(path) {
+  if (!existsSync(path)) return {}
+  const raw = readFileSync(path, 'utf8')
+  if (!raw.trim()) return {}
+  try { return JSON.parse(raw) } catch (e) { throw new Error(`malformed_claude_json: ${e.message}`) }
+}
+export function installAgent({
+  claudeJsonPath = defaultClaudeJsonPath(),
+  skillsDir = defaultSkillsDir(),
+  skillTemplatePath = defaultSkillTemplatePath(),
+  port,
+  version,
+} = {}) {
+  if (!port) throw new Error('port_required')
+  if (!version) throw new Error('version_required')
+  const changes = []
+  const cur = readClaudeJson(claudeJsonPath)
+  cur.mcpServers = cur.mcpServers || {}
+  const desired = {
+    type: 'http',
+    url: `http://127.0.0.1:${port}/mcp`,
+  }
+  const prev = cur.mcpServers.agentquad
+  const prevMarker = cur._agentquadManaged
+  const samePort = prev && prev.url === desired.url
+  const sameVersion = prevMarker && prevMarker.version === version
+  cur.mcpServers.agentquad = desired
+  if (samePort && sameVersion && isAgentquadManaged(cur)) {
+    // 保留旧 generatedAt，让 idempotent 写回不改 hash
+    cur._agentquadManaged = prevMarker
+  } else {
+    cur._agentquadManaged = buildMarker({ version, port })
+    changes.push('mcp_registered')
+  }
+  writeJsonAtomic(claudeJsonPath, cur)
+  // skill
+  const skillDir = join(skillsDir, SKILL_NAME)
+  const skillFile = join(skillDir, 'SKILL.md')
+  if (!existsSync(skillFile) || readFileSync(skillFile, 'utf8') !== readFileSync(skillTemplatePath, 'utf8')) {
+    mkdirSync(skillDir, { recursive: true })
+    copyFileSync(skillTemplatePath, skillFile)
+    changes.push('skill_installed')
+  }
+  return { ok: true, changes, configPath: claudeJsonPath, skillPath: skillFile }
+}
+export function uninstallAgent({
+  claudeJsonPath = defaultClaudeJsonPath(),
+  skillsDir = defaultSkillsDir(),
+} = {}) {
+  const removed = []
+  if (existsSync(claudeJsonPath)) {
+    const cur = readClaudeJson(claudeJsonPath)
+    if (cur.mcpServers?.agentquad) {
+      delete cur.mcpServers.agentquad
+      removed.push('mcp_entry')
+    }
+    if (cur._agentquadManaged) {
+      delete cur._agentquadManaged
+      removed.push('marker')
+    }
+    if (removed.length > 0) writeJsonAtomic(claudeJsonPath, cur)
+  }
+  const skillDir = join(skillsDir, SKILL_NAME)
+  if (existsSync(skillDir)) {
+    rmSync(skillDir, { recursive: true, force: true })
+    removed.push('skill')
+  }
+  return { ok: true, removed }
+}
+export function inspectAgent({
+  claudeJsonPath = defaultClaudeJsonPath(),
+  skillsDir = defaultSkillsDir(),
+  expectedPort = null,
+} = {}) {
+  const out = {
+    target: 'claude',
+    mcpRegistered: false,
+    skillPresent: false,
+    drift: false,
+    configPath: claudeJsonPath,
+    expectedPort,
+    actualPort: null,
+    version: null,
+  }
+  if (existsSync(claudeJsonPath)) {
+    try {
+      const cur = readClaudeJson(claudeJsonPath)
+      if (cur.mcpServers?.agentquad?.url) {
+        out.mcpRegistered = true
+        const m = cur.mcpServers.agentquad.url.match(/:(\d+)\//)
+        if (m) out.actualPort = Number(m[1])
+        out.version = cur._agentquadManaged?.version || null
+      }
+    } catch { /* malformed, treat as not registered */ }
+  }
+  if (existsSync(join(skillsDir, SKILL_NAME, 'SKILL.md'))) out.skillPresent = true
+  if (out.mcpRegistered && expectedPort && out.actualPort !== expectedPort) out.drift = true
+  return out
+}

package/src/cli.js CHANGED Viewed

@@ -361,9 +361,127 @@ export async function doctorReport({ rootDir = DEFAULT_ROOT_DIR } = {}) {
     // 注：hook check 已经在 openclaw 段做过；不重复
   }
+  // ─── agents（claude/codex/cursor 的 AgentQuad MCP + skill 装机状态）──────
+  try {
+    const { inspectAllAgents } = await import('./agent-installer-dispatcher.js')
+    const { listStaleRuntimeConfigs } = await import('./agent-installer-shared.js')
+    const expectedPort = cfg?.port || 5677
+    const r = inspectAllAgents({ expectedPort })
+    for (const [t, ins] of Object.entries(r.results)) {
+      if (ins.error) {
+        checks.push({ name: `agents.${t}`, ok: false, detail: `error reading config: ${ins.error}` })
+        continue
+      }
+      const mcpOk = ins.mcpRegistered
+      const skillOk = ins.skillPresent
+      const both = mcpOk && skillOk
+      const fixHint = `跑 \`agentquad agents install --target ${t}\``
+      const parts = []
+      parts.push(mcpOk ? 'MCP ✓' : 'MCP ✗')
+      parts.push(skillOk ? 'skill ✓' : 'skill ✗')
+      if (ins.drift) parts.push(`⚠ drift (actual:${ins.actualPort} expected:${ins.expectedPort})`)
+      checks.push({
+        name: `agents.${t}`,
+        ok: both && !ins.drift,
+        detail: both && !ins.drift
+          ? parts.join('  ')
+          : `${parts.join('  ')} — 修复: ${fixHint}`,
+      })
+    }
+    // orphan runtime configs
+    const runtimeDir = cfg?.agents?.runtimeDir
+      ? cfg.agents.runtimeDir.replace(/^~/, homedir())
+      : join(homedir(), '.agentquad', 'run')
+    const stale = listStaleRuntimeConfigs({ runtimeDir })
+    if (stale.length > 0) {
+      checks.push({
+        name: 'agents runtime orphans',
+        ok: true, // 仅 warning，不影响整体 ok
+        detail: `${stale.length} 个 24h+ 未刷新的运行时 MCP 配置在 ${runtimeDir}（可手动删除）`,
+      })
+    }
+    // active PTY soft warning — 查 running server's /api/status
+    try {
+      const pidInfo = readPidFile(DEFAULT_ROOT_DIR)
+      if (pidInfo?.pid && isAlive(pidInfo.pid)) {
+        const port = pidInfo.port ?? expectedPort
+        const resp = await fetch(`http://127.0.0.1:${port}/api/status`, { signal: AbortSignal.timeout(1500) })
+        const body = await resp.json()
+        const active = body.activeSessions ?? 0
+        const warnAt = cfg?.agents?.warnPtyCount || 8
+        if (active >= warnAt) {
+          checks.push({
+            name: 'agents pty count',
+            ok: true, // 仅 warning
+            detail: `⚠ 活跃 AgentQuad PTY 数 = ${active}（≥ 阈值 ${warnAt}，请留意是否失控）`,
+          })
+        }
+      }
+    } catch { /* server 没在跑 / 网络抖动，忽略 */ }
+  } catch (e) {
+    checks.push({ name: 'agents check', ok: false, detail: `agents inspect failed: ${e?.message || e}` })
+  }
   return { ok: checks.every(c => c.ok), checks }
 }
+async function promptYesNo(question) {
+  const readline = await import('node:readline')
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  return new Promise((resolve) => {
+    rl.question(question, (a) => {
+      rl.close()
+      const text = (a || '').trim().toLowerCase()
+      // empty input → default Yes
+      resolve(text === '' || text === 'y' || text === 'yes')
+    })
+  })
+}
+async function bootstrapAgentsIfNeeded({ cfg, version, port, isTTY }) {
+  const mode = cfg?.agents?.autoBootstrap || 'prompt'
+  if (mode === 'never') return
+  if (cfg?.agents?.bootstrapDismissed) return
+  const { previewAllAgents, installAllAgents } = await import('./agent-installer-dispatcher.js')
+  const p = previewAllAgents({ port, version })
+  const needed = Object.entries(p.results)
+    .filter(([, v]) => (v.changes || []).length > 0)
+    .map(([k]) => k)
+  if (needed.length === 0) return
+  if (mode === 'silent') {
+    const r = installAllAgents({ port, version, only: needed })
+    console.log(`[agents] auto bootstrap: ${Object.keys(r.results).join(', ')}`)
+    return
+  }
+  if (!isTTY) {
+    console.warn(`[agents] 检测到未配置的 agent 工具: ${needed.join(', ')}（运行 \`agentquad agents install\` 启用）`)
+    return
+  }
+  // prompt mode (interactive TTY)
+  const ok = await promptYesNo(`[agents] 检测到 ${needed.join(', ')} 未配置 AgentQuad MCP / skill，现在安装吗？[Y/n] `)
+  if (ok) {
+    const r = installAllAgents({ port, version, only: needed })
+    for (const [t, res] of Object.entries(r.results)) {
+      console.log(`  ${t}: ${res.ok ? (res.changes?.join(', ') || 'ok') : `error: ${res.error}`}`)
+    }
+  } else {
+    try {
+      setConfigValue('agents.bootstrapDismissed', 'true')
+    } catch (e) {
+      console.warn(`[agents] 持久化 dismissed 失败: ${e.message}`)
+    }
+    console.log('[agents] 已记住你的选择；运行 `agentquad agents install` 可手动启用')
+  }
+}
 // runStart：start 子命令的核心实现，导出给默认 action / 首跑向导复用
 export async function runStart(cmdOpts = {}) {
   // dry-run 短路（仅用于测试，让默认 action 测试不真起服务 / 不跑向导）
@@ -505,6 +623,19 @@ export async function runStart(cmdOpts = {}) {
     }
   }
+  // ─── 自动 bootstrap 三家 AI CLI 的 AgentQuad MCP + skill（agents）───
+  try {
+    const pkg = JSON.parse(readFileSync(resolvePath(__dirname, '../package.json'), 'utf8'))
+    await bootstrapAgentsIfNeeded({
+      cfg,
+      version: pkg.version,
+      port: actualPort,
+      isTTY: !!process.stdin.isTTY && !!process.stdout.isTTY,
+    })
+  } catch (e) {
+    console.warn(`[agents] bootstrap failed: ${e?.message || e}`)
+  }
   // listen 完成后异步发"重启完成 + Resume N 个会话"通知到 telegram。
   // 不 await，发不发都不阻塞 boot；postText 走 telegram HTTPS 直发，不依赖 long-poll
   if (typeof srv.notifyStartupRecovery === 'function') {
@@ -1061,6 +1192,83 @@ addToolFlags(hookCmd.command('bootstrap'))
   .description('一键部署 hook script + 安装 hooks（强制忽略 .uninstalled marker，用于"删过又想恢复"场景）')
   .action(actBootstrapHookMulti)
+// ─── agents 子命令组：装/卸 AgentQuad MCP + skill 到 Claude Code / Codex / Cursor ───
+const agentsCmd = program.command('agents').description('为 Claude Code / Codex / Cursor 装 AgentQuad MCP + skill（嵌套子 agent 能力）')
+const VALID_AGENT_TARGETS = ['claude', 'codex', 'cursor']
+function addAgentTargetFlag(cmd) {
+  return cmd.option('--target <name>', '指定 claude / codex / cursor，多次传入累加', (v, acc = []) => {
+    if (!VALID_AGENT_TARGETS.includes(v)) throw new Error(`unknown agents target: ${v}`)
+    acc.push(v)
+    return acc
+  }, undefined)
+}
+function readAgentsCtx() {
+  const pkg = JSON.parse(readFileSync(resolvePath(__dirname, '../package.json'), 'utf8'))
+  const cfg = loadConfig()
+  return { port: cfg.port || 5677, version: pkg.version }
+}
+addAgentTargetFlag(agentsCmd.command('install'))
+  .description('合并写入 MCP 配置 + skill 文件；默认装三家')
+  .option('--dry-run', '只 preview 不写盘')
+  .action(async (opts) => {
+    const { installAllAgents, previewAllAgents } = await import('./agent-installer-dispatcher.js')
+    const { port, version } = readAgentsCtx()
+    const only = opts.target || null
+    if (opts.dryRun) {
+      const p = previewAllAgents({ port, version, only })
+      console.log('dry-run preview:')
+      for (const [t, r] of Object.entries(p.results)) {
+        const text = r.changes && r.changes.length ? r.changes.join(', ') : 'no changes'
+        console.log(`  ${t}: ${text}`)
+      }
+      if (p.summary?.failed?.length) {
+        for (const t of p.summary.failed) console.error(`  ${t}: error — ${p.results[t]?.error || 'unknown'}`)
+      }
+      return
+    }
+    const r = installAllAgents({ port, version, only })
+    for (const [t, res] of Object.entries(r.results)) {
+      if (res.ok) console.log(`✓ ${t}:`, res.changes?.length ? res.changes.join(', ') : 'already up to date')
+      else console.error(`✗ ${t}:`, res.error)
+    }
+    if (r.summary?.failed?.length) process.exitCode = 1
+  })
+addAgentTargetFlag(agentsCmd.command('uninstall'))
+  .description('删除 marker 段 + skill 文件；用户其他 mcpServers / skill 不动')
+  .action(async (opts) => {
+    const { uninstallAllAgents } = await import('./agent-installer-dispatcher.js')
+    const only = opts.target || null
+    const r = uninstallAllAgents({ only })
+    for (const [t, res] of Object.entries(r.results)) {
+      if (res.ok) console.log(`✓ ${t}: removed`, (res.removed || []).join(', ') || 'nothing')
+      else console.error(`✗ ${t}:`, res.error)
+    }
+    if (r.summary?.failed?.length) process.exitCode = 1
+  })
+agentsCmd.command('status')
+  .description('查看三家 agent 工具的 AgentQuad MCP / skill 安装状态 + drift')
+  .action(async () => {
+    const { inspectAllAgents } = await import('./agent-installer-dispatcher.js')
+    const { port } = readAgentsCtx()
+    const r = inspectAllAgents({ expectedPort: port })
+    for (const [t, ins] of Object.entries(r.results)) {
+      if (ins.error) {
+        console.log(`  ${t.padEnd(8)} ✗ error — ${ins.error}`)
+        continue
+      }
+      const mcp = ins.mcpRegistered ? '✓ MCP' : '✗ MCP'
+      const sk = ins.skillPresent ? '✓ skill' : '✗ skill'
+      const drift = ins.drift ? `  ⚠ drift (actual:${ins.actualPort} expected:${ins.expectedPort})` : ''
+      console.log(`  ${t.padEnd(8)} ${mcp}   ${sk}   ${ins.configPath}${drift}`)
+    }
+  })
 // ─── openclaw 子命令组：保留旧路径以向后兼容；hook 操作建议改用 `agentquad hook *` ───
 const openclawCmd = program.command('openclaw').description('OpenClaw bridge: install/uninstall Claude Code hooks for proactive WeChat push')