helloagents 3.1.7 → 3.1.9

package/scripts/cli-lifecycle-hosts.mjs

@@ -2,9 +2,13 @@ import { platform } from 'node:os'
 
 import {
   installClaudeStandby,
+  installCursorStandby,
   installGeminiStandby,
+  installGrokStandby,
   uninstallClaudeStandby,
+  uninstallCursorStandby,
   uninstallGeminiStandby,
+  uninstallGrokStandby,
 } from './cli-hosts.mjs'
 import {
   cleanupCodexGlobalResidueForStandby,
@@ -20,16 +24,28 @@ import {
 } from './cli-host-detect.mjs'
 import {
   getClaudeMarketplaceRoot,
+  getCursorInstallRoot,
+  getCursorPluginRoot,
   getGeminiExtensionRoot,
+  getGrokMarketplaceRoot,
   removeClaudeMarketplaceRoot,
+  removeCursorInstallRoot,
+  removeCursorPluginRoot,
   removeGeminiExtensionRoot,
+  removeGrokMarketplaceRoot,
   syncClaudeMarketplaceRoot,
+  syncCursorInstallRoot,
+  syncCursorPluginRoot,
   syncGeminiExtensionRoot,
+  syncGrokMarketplaceRoot,
 } from './cli-runtime-root.mjs'
+import { removeIfExists } from './cli-utils.mjs'
 
 const CLAUDE_COMMAND = process.env.HELLOAGENTS_CLAUDE_CMD || 'claude'
 const GEMINI_COMMAND = process.env.HELLOAGENTS_GEMINI_CMD || 'gemini'
+const GROK_COMMAND = process.env.HELLOAGENTS_GROK_CMD || 'grok'
 const CLAUDE_PLUGIN = 'helloagents@helloagents'
+const GROK_PLUGIN = 'helloagents'
 
 function normalizeCommand(command = '') {
   return String(command || '').trim()
@@ -89,6 +105,25 @@ function preserveTrackedModeOnFailure(result = {}, trackedMode = '') {
   return result
 }
 
+function isBenignGrokPluginMissing(result = {}) {
+  return /Plugin "helloagents" not found\./i.test(result.output || '')
+}
+
+function isBenignGrokMarketplaceMissing(result = {}) {
+  return /Marketplace source ".*" not found\./i.test(result.output || '')
+}
+
+function isBenignGrokMarketplaceExists(result = {}) {
+  return /Marketplace source already configured:/i.test(result.output || '')
+}
+
+function grokCleanupStepSucceeded(result = {}, { allowMissing = false, allowAlreadyExists = false } = {}) {
+  if (result.ok) return true
+  if (allowMissing && (isBenignGrokPluginMissing(result) || isBenignGrokMarketplaceMissing(result))) return true
+  if (allowAlreadyExists && isBenignGrokMarketplaceExists(result)) return true
+  return false
+}
+
 function installClaudeGlobalPlugin(marketplaceRoot) {
   const add = runHostCommand(CLAUDE_COMMAND, ['plugin', 'marketplace', 'add', marketplaceRoot])
   if (!add.ok && add.missing) return { ok: false, output: '未找到 claude 命令' }
@@ -108,6 +143,64 @@ function removeGeminiGlobalExtension() {
   return runHostCommand(GEMINI_COMMAND, ['extensions', 'uninstall', 'helloagents'])
 }
 
+function installCursorGlobalPlugin(runtime) {
+  try {
+    const projectionRoot = getCursorPluginRoot(runtime.home)
+    const installRoot = getCursorInstallRoot(runtime.home)
+    syncCursorPluginRoot(runtime.pkgRoot, projectionRoot)
+    removeIfExists(installRoot)
+    syncCursorInstallRoot(projectionRoot, installRoot)
+    return { ok: true, output: '' }
+  } catch (error) {
+    return {
+      ok: false,
+      output: error?.message || String(error),
+    }
+  }
+}
+
+function removeCursorGlobalPlugin(runtime) {
+  try {
+    removeCursorInstallRoot(runtime.home)
+    removeCursorPluginRoot(runtime.home)
+    return { ok: true, output: '' }
+  } catch (error) {
+    return {
+      ok: false,
+      output: error?.message || String(error),
+    }
+  }
+}
+
+function installGrokGlobalPlugin(marketplaceRoot) {
+  const pluginRoot = `${marketplaceRoot}${platform() === 'win32' ? '\\' : '/'}plugins${platform() === 'win32' ? '\\' : '/'}${GROK_PLUGIN}`
+  const uninstall = runHostCommand(GROK_COMMAND, ['plugin', 'uninstall', GROK_PLUGIN, '--confirm'])
+  if (uninstall.missing) return uninstall
+  if (!grokCleanupStepSucceeded(uninstall, { allowMissing: true })) return uninstall
+
+  const removeMarketplace = runHostCommand(GROK_COMMAND, ['plugin', 'marketplace', 'remove', marketplaceRoot])
+  if (removeMarketplace.missing) return removeMarketplace
+  if (!grokCleanupStepSucceeded(removeMarketplace, { allowMissing: true })) return removeMarketplace
+
+  const addMarketplace = runHostCommand(GROK_COMMAND, ['plugin', 'marketplace', 'add', marketplaceRoot])
+  if (addMarketplace.missing) return addMarketplace
+  if (!grokCleanupStepSucceeded(addMarketplace, { allowAlreadyExists: true })) return addMarketplace
+
+  return runHostCommand(GROK_COMMAND, ['plugin', 'install', pluginRoot, '--trust'])
+}
+
+function removeGrokGlobalPlugin(marketplaceRoot) {
+  const uninstall = runHostCommand(GROK_COMMAND, ['plugin', 'uninstall', GROK_PLUGIN, '--confirm'])
+  if (uninstall.missing) return uninstall
+  if (!grokCleanupStepSucceeded(uninstall, { allowMissing: true })) return uninstall
+
+  const removeMarketplace = runHostCommand(GROK_COMMAND, ['plugin', 'marketplace', 'remove', marketplaceRoot])
+  if (removeMarketplace.missing) return removeMarketplace
+  if (!grokCleanupStepSucceeded(removeMarketplace, { allowMissing: true })) return removeMarketplace
+
+  return { ok: true, output: `${uninstall.output || ''}\n${removeMarketplace.output || ''}`.trim() }
+}
+
 function reportHostAction(runtime, action, host, mode, result = {}) {
   const label = getHostLabel(host)
   const isCleanup = action === 'cleanup' || action === 'uninstall'
@@ -161,6 +254,21 @@ function prepareGeminiStandby(previousMode) {
   )
 }
 
+function prepareGrokStandby(runtime, previousMode) {
+  if (previousMode !== 'global') return {}
+  const marketplaceRoot = getGrokMarketplaceRoot(runtime.home)
+  return preserveTrackedModeOnFailure(
+    buildNativeResult(
+      removeGrokGlobalPlugin(marketplaceRoot),
+      '已自动移除 Grok Build 插件与 marketplace 来源',
+      'Grok Build plugin and marketplace source removed automatically',
+      `切到 standby 前无法自动移除 Grok Build 插件，请先手动执行: grok plugin uninstall ${GROK_PLUGIN} --confirm；grok plugin marketplace remove "${marketplaceRoot}"`,
+      `Could not remove the Grok Build plugin before switching to standby. Run manually: grok plugin uninstall ${GROK_PLUGIN} --confirm; grok plugin marketplace remove "${marketplaceRoot}"`,
+    ),
+    'global',
+  )
+}
+
 function installHostStandby(runtime, host, { previousMode = '' } = {}) {
   if (host === 'claude') {
     const cleanupResult = prepareClaudeStandby(previousMode)
@@ -176,6 +284,25 @@ function installHostStandby(runtime, host, { previousMode = '' } = {}) {
     if (detectRuntimeHostMode('gemini', runtime) !== 'global') removeGeminiExtensionRoot(runtime.home)
     return cleanupResult
   }
+  if (host === 'grok') {
+    const cleanupResult = prepareGrokStandby(runtime, previousMode)
+    if (cleanupResult.ok === false) return cleanupResult
+    installGrokStandby(runtime.home, runtime.pkgRoot)
+    if (detectRuntimeHostMode('grok', runtime) !== 'global') removeGrokMarketplaceRoot(runtime.home)
+    return cleanupResult
+  }
+  if (host === 'cursor') {
+    if (previousMode === 'global') {
+      const cleanupResult = removeCursorGlobalPlugin(runtime)
+      if (!cleanupResult.ok) return cleanupResult
+    }
+    installCursorStandby(runtime.home, runtime.pkgRoot)
+    if (detectRuntimeHostMode('cursor', runtime) !== 'global') {
+      removeCursorInstallRoot(runtime.home)
+      removeCursorPluginRoot(runtime.home)
+    }
+    return {}
+  }
   if (!installCodexStandby(runtime.home, runtime.pkgRoot)) return { skipped: true }
   cleanupCodexGlobalResidueForStandby(runtime.home)
   return {}
@@ -208,6 +335,28 @@ function installHostGlobal(runtime, host) {
     )
     return result
   }
+  if (host === 'grok') {
+    uninstallGrokStandby(runtime.home)
+    const marketplaceRoot = getGrokMarketplaceRoot(runtime.home)
+    syncGrokMarketplaceRoot(runtime.pkgRoot, marketplaceRoot)
+    return buildNativeResult(
+      installGrokGlobalPlugin(marketplaceRoot),
+      '已自动安装 Grok Build 原生插件；重启 Grok Build 后生效',
+      'Grok Build native plugin installed automatically; restart Grok Build to apply',
+      `Grok Build 原生插件自动安装失败，请手动执行: grok plugin marketplace add "${marketplaceRoot}"；grok plugin install "${marketplaceRoot}${platform() === 'win32' ? '\\' : '/'}plugins${platform() === 'win32' ? '\\' : '/'}${GROK_PLUGIN}" --trust`,
+      `Grok Build native plugin auto-install failed. Run manually: grok plugin marketplace add "${marketplaceRoot}"; grok plugin install "${marketplaceRoot}${platform() === 'win32' ? '\\' : '/'}plugins${platform() === 'win32' ? '\\' : '/'}${GROK_PLUGIN}" --trust`,
+    )
+  }
+  if (host === 'cursor') {
+    uninstallCursorStandby(runtime.home)
+    return buildNativeResult(
+      installCursorGlobalPlugin(runtime),
+      '已自动安装 Cursor 原生本地插件；重启 Cursor 后生效',
+      'Cursor native local plugin installed automatically; restart Cursor to apply',
+      `Cursor 本地插件自动安装失败，请将 "${getCursorPluginRoot(runtime.home)}" 的内容复制到 "${getCursorInstallRoot(runtime.home)}"`,
+      `Cursor local plugin auto-install failed. Copy the contents of "${getCursorPluginRoot(runtime.home)}" into "${getCursorInstallRoot(runtime.home)}"`,
+    )
+  }
   uninstallCodexStandby(runtime.home)
   return installCodexGlobal(runtime.home, runtime.pkgRoot) ? {} : { skipped: true }
 }
@@ -223,6 +372,19 @@ function cleanupHostStandby(runtime, host) {
     if (detectRuntimeHostMode('gemini', runtime) !== 'global') removeGeminiExtensionRoot(runtime.home)
     return { skipped }
   }
+  if (host === 'grok') {
+    const skipped = !uninstallGrokStandby(runtime.home)
+    if (detectRuntimeHostMode('grok', runtime) !== 'global') removeGrokMarketplaceRoot(runtime.home)
+    return { skipped }
+  }
+  if (host === 'cursor') {
+    const skipped = !uninstallCursorStandby(runtime.home)
+    if (detectRuntimeHostMode('cursor', runtime) !== 'global') {
+      removeCursorInstallRoot(runtime.home)
+      removeCursorPluginRoot(runtime.home)
+    }
+    return { skipped }
+  }
   const standbyCleaned = uninstallCodexStandby(runtime.home)
   const globalResidueCleaned = uninstallCodexGlobal(runtime.home)
   return { skipped: !(standbyCleaned || globalResidueCleaned) }
@@ -259,6 +421,32 @@ function cleanupHostGlobal(runtime, host) {
     if (result.ok) removeGeminiExtensionRoot(runtime.home)
     return result
   }
+  if (host === 'grok') {
+    uninstallGrokStandby(runtime.home)
+    const marketplaceRoot = getGrokMarketplaceRoot(runtime.home)
+    const result = preserveTrackedModeOnFailure(
+      buildNativeResult(
+        removeGrokGlobalPlugin(marketplaceRoot),
+        '已自动移除 Grok Build 插件与 marketplace 来源',
+        'Grok Build plugin and marketplace source removed automatically',
+        `Grok Build 原生插件自动移除失败，请手动执行: grok plugin uninstall ${GROK_PLUGIN} --confirm；grok plugin marketplace remove "${marketplaceRoot}"`,
+        `Grok Build native plugin auto-remove failed. Run manually: grok plugin uninstall ${GROK_PLUGIN} --confirm; grok plugin marketplace remove "${marketplaceRoot}"`,
+      ),
+      'global',
+    )
+    if (result.ok) removeGrokMarketplaceRoot(runtime.home)
+    return result
+  }
+  if (host === 'cursor') {
+    uninstallCursorStandby(runtime.home)
+    return buildNativeResult(
+      removeCursorGlobalPlugin(runtime),
+      '已自动移除 Cursor 本地插件安装目录与投影目录',
+      'Cursor local plugin install directory and projection root removed automatically',
+      `Cursor 本地插件自动移除失败，请删除 "${getCursorInstallRoot(runtime.home)}" 与 "${getCursorPluginRoot(runtime.home)}"`,
+      `Cursor local plugin auto-remove failed. Delete "${getCursorInstallRoot(runtime.home)}" and "${getCursorPluginRoot(runtime.home)}"`,
+    )
+  }
   return { skipped: !uninstallCodexGlobal(runtime.home) }
 }
 
@@ -270,6 +458,12 @@ function installStandby(runtime, previousModes = {}) {
   const geminiResult = installHostStandby(runtime, 'gemini', { previousMode: previousModes.gemini || '' })
   reportHostAction(runtime, 'install', 'gemini', 'standby', geminiResult)
   results.gemini = geminiResult.skipped ? { skipped: true } : geminiResult
+  const grokResult = installHostStandby(runtime, 'grok', { previousMode: previousModes.grok || '' })
+  reportHostAction(runtime, 'install', 'grok', 'standby', grokResult)
+  results.grok = grokResult.skipped ? { skipped: true } : grokResult
+  const cursorResult = installHostStandby(runtime, 'cursor', { previousMode: previousModes.cursor || '' })
+  reportHostAction(runtime, 'install', 'cursor', 'standby', cursorResult)
+  results.cursor = cursorResult.skipped ? { skipped: true } : cursorResult
   if (installCodexStandby(runtime.home, runtime.pkgRoot)) {
     cleanupCodexGlobalResidueForStandby(runtime.home)
     runtime.ok(runtime.msg('Codex CLI 已配置（standby 模式）', 'Codex CLI configured (standby mode)'))
@@ -283,7 +477,7 @@ function installStandby(runtime, previousModes = {}) {
 
 function installGlobal(runtime) {
   const results = {}
-  for (const host of ['claude', 'gemini', 'codex']) {
+  for (const host of ['claude', 'gemini', 'grok', 'cursor', 'codex']) {
     const result = installHostGlobal(runtime, host)
     reportHostAction(runtime, 'install', host, 'global', result)
     results[host] = result
@@ -299,6 +493,8 @@ export function installAllHosts(runtime, mode, { previousModes = {} } = {}) {
 export function uninstallAllHosts(runtime) {
   cleanupHostGlobal(runtime, 'claude')
   cleanupHostGlobal(runtime, 'gemini')
+  cleanupHostGlobal(runtime, 'grok')
+  cleanupHostGlobal(runtime, 'cursor')
   uninstallCodexStandby(runtime.home)
   uninstallCodexGlobal(runtime.home)
 }

package/scripts/cli-lifecycle.mjs

@@ -10,7 +10,7 @@ import {
 import { installAllHosts, runHostLifecycle } from './cli-lifecycle-hosts.mjs'
 import { ensureDir, safeJson, safeWrite } from './cli-utils.mjs'
 
-export const HOSTS = ['claude', 'gemini', 'codex']
+export const HOSTS = ['claude', 'gemini', 'grok', 'cursor', 'codex']
 
 const runtime = {
   home: '',
@@ -165,7 +165,9 @@ export function syncVersion() {
   const packageRoot = runtime.sourceRoot || runtime.pkgRoot
   const targets = [
     join(packageRoot, '.claude-plugin', 'plugin.json'),
+    join(packageRoot, '.cursor-plugin', 'plugin.json'),
     join(packageRoot, '.codex-plugin', 'plugin.json'),
+    join(packageRoot, '.grok-plugin', 'plugin.json'),
     join(packageRoot, 'gemini-extension.json'),
   ]
   for (const path of targets) {

package/scripts/cli-messages.mjs

@@ -1,6 +1,12 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
-import { getClaudeMarketplaceRoot, getGeminiExtensionRoot } from './cli-runtime-root.mjs'
+import {
+  getClaudeMarketplaceRoot,
+  getCursorInstallRoot,
+  getCursorPluginRoot,
+  getGeminiExtensionRoot,
+  getGrokMarketplaceRoot,
+} from './cli-runtime-root.mjs'
 
 export function createMessageHelpers(isCN) {
   const msg = (cn, en) => (isCN ? cn : en)
@@ -21,17 +27,21 @@ function codexGlobalStatus({ home, msg }) {
 }
 
 function pluginCommands(home) {
+  const grokMarketplaceRoot = getGrokMarketplaceRoot(home)
   return [
     `    Claude Code:  /plugin marketplace add "${getClaudeMarketplaceRoot(home)}"`,
     '                  /plugin install helloagents@helloagents',
     `    Gemini CLI:   gemini extensions link "${getGeminiExtensionRoot(home)}"`,
+    `    Grok Build:   grok plugin marketplace add "${grokMarketplaceRoot}"`,
+    `                  grok plugin install "${join(grokMarketplaceRoot, 'plugins', 'helloagents')}" --trust`,
+    `    Cursor:       copy "${getCursorPluginRoot(home)}" -> "${getCursorInstallRoot(home)}"`,
   ].join('\n')
 }
 
 function removeHint(msg) {
   return msg(
-    '如已安装 Claude Code 插件，可手动移除: /plugin remove helloagents\n  如已安装 Gemini CLI 扩展，可手动移除: gemini extensions uninstall helloagents',
-    'If the Claude Code plugin is installed, you can remove it: /plugin remove helloagents\n  If the Gemini CLI extension is installed, you can remove it: gemini extensions uninstall helloagents',
+    `如已安装 Claude Code 插件，可手动移除: /plugin remove helloagents\n  如已安装 Gemini CLI 扩展，可手动移除: gemini extensions uninstall helloagents\n  如已安装 Grok Build 插件，可手动移除: grok plugin uninstall helloagents --confirm\n  如已安装 Cursor 本地插件，可手动删除: ${getCursorInstallRoot(process.env.HOME || process.env.USERPROFILE || '~')}`,
+    `If the Claude Code plugin is installed, you can remove it: /plugin remove helloagents\n  If the Gemini CLI extension is installed, you can remove it: gemini extensions uninstall helloagents\n  If the Grok Build plugin is installed, you can remove it: grok plugin uninstall helloagents --confirm\n  If the Cursor local plugin is installed, remove: ${getCursorInstallRoot(process.env.HOME || process.env.USERPROFILE || '~')}`,
   )
 }
 
@@ -50,24 +60,24 @@ function renderInstallMessage(context, mode, state) {
   if (mode === 'global') {
     if (install) {
       return msg(
-        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI: 已自动尝试宿主原生插件/扩展安装\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands(home)}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
-        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI: native plugin/extension install attempted automatically\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands(home)}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
+        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI / Grok Build: 已自动尝试宿主原生插件或 marketplace 安装\n    Cursor:       已自动安装原生本地插件（~/.cursor/plugins/local/helloagents）\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands(home)}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
+        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI / Grok Build: native plugin or marketplace install attempted automatically\n    Cursor:       Native local plugin installed automatically (~/.cursor/plugins/local/helloagents)\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands(home)}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
       )
     }
     return msg(
       refresh
-        ? `  global 模式已刷新。\n  Claude Code / Gemini 已自动尝试刷新宿主插件/扩展；Codex 原生本地插件已重装并同步最新文件。\n  ${restartHint(msg)}`
-        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini 已自动尝试安装宿主插件/扩展；Codex 已自动安装原生本地插件。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands(home)}`,
+        ? `  global 模式已刷新。\n  Claude Code / Gemini / Grok 已自动尝试刷新宿主原生插件或 marketplace；Cursor / Codex 原生本地插件已重装并同步最新文件。\n  ${restartHint(msg)}`
+        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini / Grok 已自动尝试安装宿主原生插件或 marketplace；Cursor / Codex 已自动安装原生本地插件。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands(home)}`,
       refresh
-        ? `  Global mode refreshed.\n  Claude Code / Gemini native plugin/extension refresh was attempted automatically; Codex native local-plugin files were reinstalled and synced.\n  ${restartHint(msg)}`
-        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini native plugin/extension install was attempted automatically; Codex now uses the native local-plugin path automatically.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands(home)}`,
+        ? `  Global mode refreshed.\n  Claude Code / Gemini / Grok native plugin or marketplace refresh was attempted automatically; Cursor / Codex native local-plugin files were reinstalled and synced.\n  ${restartHint(msg)}`
+        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini / Grok native plugin or marketplace install was attempted automatically; Cursor / Codex now use the native local-plugin path automatically.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands(home)}`,
     )
   }
 
   if (install) {
     return msg(
-      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~init 初始化完整项目工作流；未初始化时也可继续用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    宿主级全局部署（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
-      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~init to initialize the full project workflow; uninitialized repos can still use ~command on demand.\n\n  Switch modes:\n    helloagents --global    Host-wide global deployment (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
+      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Grok Build:   已自动配置（~/.grok/AGENTS.md + hooks）\n    Cursor:       已自动配置（~/.cursor/hooks.json + runtime link）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~init 初始化完整项目工作流；未初始化时也可继续用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    宿主级全局部署（自动尝试 Claude/Gemini/Grok 原生插件或 marketplace；Cursor/Codex 自动装原生本地插件）`,
+      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Grok Build:   Auto-configured (~/.grok/AGENTS.md + hooks)\n    Cursor:       Auto-configured (~/.cursor/hooks.json + runtime link)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~init to initialize the full project workflow; uninitialized repos can still use ~command on demand.\n\n  Switch modes:\n    helloagents --global    Host-wide global deployment (auto-attempts Claude/Gemini/Grok native plugin or marketplace installs; native local plugin auto-install for Cursor/Codex)`,
     )
   }
 
@@ -81,7 +91,7 @@ function renderInstallMessage(context, mode, state) {
   )
 }
 
-function renderHelp({ pkgVersion, msg }) {
+function renderHelp({ pkgVersion, msg, home }) {
   return `
 HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
 
@@ -91,17 +101,19 @@ HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
   helloagents-js             ${msg('（受管宿主配置的跨平台稳定入口）', '(cross-platform stable entrypoint for managed host configs)')}
 
 ${msg('模式切换', 'Mode switching')}:
-  helloagents --global     ${msg('宿主级全局部署（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Host-wide global deployment (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
+  helloagents --global     ${msg('宿主级全局部署（自动尝试 Claude/Gemini/Grok 原生插件或 marketplace；Cursor/Codex 自动装原生本地插件）', 'Host-wide global deployment (auto-attempts Claude/Gemini/Grok native plugin or marketplace installs; native local plugin auto-install for Cursor/Codex)')}
   helloagents --standby    ${msg('标准模式（非插件安装，hello-* 不自动触发，默认）', "Standby mode (non-plugin install, hello-* won't auto-trigger, default)")}
 
 ${msg('单 CLI 管理', 'Scoped CLI management')}:
   helloagents install codex --standby
   helloagents install gemini --standby
+  helloagents install grok --global
+  helloagents install cursor --global
   helloagents install --all --global
   helloagents update codex
   helloagents cleanup claude --global
   helloagents uninstall gemini
-  ${msg('支持: claude | gemini | codex | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | codex | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
+  ${msg('支持: claude | gemini | grok | cursor | codex | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | grok | cursor | codex | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
 
 ${msg('分支切换', 'Branch switching')}:
   helloagents switch-branch beta
@@ -125,6 +137,8 @@ ${msg('卸载', 'Uninstall')}:
   ${msg('如宿主命令不可用，另需手动移除：', 'If host commands are unavailable, also remove manually:')}
     Claude Code:  /plugin remove helloagents
     Gemini CLI:   gemini extensions uninstall helloagents
+    Grok Build:   grok plugin uninstall helloagents --confirm
+    Cursor:       ${getCursorInstallRoot(home)}
 `.trim()
 }