helloagents 3.1.7 → 3.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.7",
+  "version": "3.1.9",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": "HelloWind",
@@ -43,14 +43,17 @@
     "install.sh",
     "install.ps1",
     "gemini-extension.json",
+    ".cursor-plugin/",
     ".claude-plugin/",
-    ".codex-plugin/"
+    ".codex-plugin/",
+    ".grok-plugin/"
   ],
   "keywords": [
     "ai",
     "agent",
     "claude",
     "codex",
+    "cursor",
     "cli",
     "orchestration",
     "subagent",

package/scripts/advisor-state.mjs

@@ -15,7 +15,7 @@ import {
 
 export const ADVISOR_EVIDENCE_FILE_NAME = 'advisor.json'
 const VALID_ADVISOR_OUTCOMES = new Set(['clean', 'findings'])
-const VALID_SOURCES = new Set(['claude', 'codex', 'gemini'])
+const VALID_SOURCES = new Set(['claude', 'codex', 'cursor', 'gemini'])
 
 function normalizeStringArray(values) {
   if (!Array.isArray(values)) return []

package/scripts/cli-config.mjs

@@ -39,7 +39,7 @@ export function ensureConfig(helloagentsHome, configFile, safeJson, ensureDir) {
   } else {
     reconciled.host_install_modes = Object.fromEntries(
       Object.entries(reconciled.host_install_modes)
-        .filter(([host, mode]) => ['claude', 'gemini', 'codex'].includes(host) && typeof mode === 'string' && mode),
+        .filter(([host, mode]) => ['claude', 'gemini', 'grok', 'cursor', 'codex'].includes(host) && typeof mode === 'string' && mode),
     );
   }
   if (JSON.stringify(reconciled) !== JSON.stringify(existing)) {

package/scripts/cli-cursor.mjs

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+import {
+  cleanHooksConfig,
+  createLink,
+  ensureDir,
+  mergeHooksConfig,
+  removeLink,
+  safeJson,
+} from './cli-utils.mjs'
+
+function readCursorHooks(pkgRoot) {
+  return safeJson(join(pkgRoot, 'hooks', 'hooks-cursor.json')) || null
+}
+
+function writeCursorStandbyHooks(home, pkgRoot) {
+  const hooksData = readCursorHooks(pkgRoot)
+  if (!hooksData) return false
+
+  const cursorDir = join(home, '.cursor')
+  ensureDir(cursorDir)
+  mergeHooksConfig(join(cursorDir, 'hooks.json'), hooksData)
+  return true
+}
+
+export function installCursorStandby(home, pkgRoot) {
+  const cursorDir = join(home, '.cursor')
+  ensureDir(cursorDir)
+  createLink(pkgRoot, join(cursorDir, 'helloagents'))
+  writeCursorStandbyHooks(home, pkgRoot)
+  return true
+}
+
+export function uninstallCursorStandby(home) {
+  const cursorDir = join(home, '.cursor')
+  if (!existsSync(cursorDir)) return false
+
+  removeLink(join(cursorDir, 'helloagents'))
+  cleanHooksConfig(join(cursorDir, 'hooks.json'))
+  return true
+}

package/scripts/cli-doctor.mjs

@@ -5,11 +5,19 @@ import { DEFAULTS } from './cli-config.mjs'
 import { inspectCodexDoctor as inspectCodexDoctorImpl } from './cli-doctor-codex.mjs'
 import { printDoctorText } from './cli-doctor-render.mjs'
 import { buildRuntimeCarrier } from './cli-runtime-carrier.mjs'
-import { getClaudeMarketplaceRoot, getGeminiExtensionRoot } from './cli-runtime-root.mjs'
+import {
+  GROK_PLUGIN_NAME,
+  getClaudeMarketplaceRoot,
+  getCursorInstallRoot,
+  getCursorPluginRoot,
+  getGeminiExtensionRoot,
+  getGrokMarketplaceRoot,
+} from './cli-runtime-root.mjs'
 import { loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
 
 const CLAUDE_PLUGIN = 'helloagents@helloagents'
 const GEMINI_EXTENSION = 'helloagents'
+const GROK_STANDBY_HOOK_FILE = 'helloagents.json'
 
 const runtime = {
   home: '',
@@ -37,7 +45,13 @@ function normalizeText(text = '') {
 }
 
 function normalizePath(value = '') {
-  return String(value || '').replace(/\\/g, '/')
+  return String(value || '').replace(/\\/g, '/').toLowerCase()
+}
+
+function textIncludesNormalizedPath(text = '', targetPath = '') {
+  const normalizedText = normalizePath(text)
+  const normalizedTargetPath = normalizePath(targetPath)
+  return Boolean(normalizedTargetPath) && normalizedText.includes(normalizedTargetPath)
 }
 
 function extractManagedCarrierContent(filePath) {
@@ -107,6 +121,15 @@ function hasEnabledPlugin(enabledPlugins, pluginName) {
   return false
 }
 
+function hasRegistryPlugin(registry = {}, pluginName, expectedSource = '') {
+  const normalizedExpectedSource = normalizePath(expectedSource)
+  return Object.values(registry?.repos || {}).some((repo) => {
+    if (!repo?.plugins?.[pluginName]) return false
+    if (!normalizedExpectedSource) return true
+    return normalizePath(repo?.kind?.source_path || '') === normalizedExpectedSource
+  })
+}
+
 function summarizeDoctorStatus(issues, { host, trackedMode, detectedMode } = {}) {
   if (issues.length > 0) return 'drift'
   if (detectedMode !== 'none') return 'ok'
@@ -193,6 +216,151 @@ function inspectClaudeDoctor(settings) {
   return { host, label: runtime.getHostLabel(host), trackedMode, detectedMode, status, checks, issues, notes, suggestedFix: suggestDoctorFix(host, status, trackedMode) }
 }
 
+function inspectCursorDoctor(settings) {
+  const host = 'cursor'
+  const trackedMode = normalizeDoctorMode(runtime.getTrackedHostMode(settings, host))
+  const detectedMode = normalizeDoctorMode(runtime.detectHostMode(host))
+  const cursorDir = join(runtime.home, '.cursor')
+  const actualHooks = safeJson(join(cursorDir, 'hooks.json')) || {}
+  const expectedHooks = readExpectedHooks('hooks-cursor.json', '')
+  const projectionRoot = getCursorPluginRoot(runtime.home)
+  const installRoot = getCursorInstallRoot(runtime.home)
+  const projectionManifestPath = join(projectionRoot, '.cursor-plugin', 'plugin.json')
+  const projectionHooksPath = join(projectionRoot, 'hooks', 'hooks-cursor.json')
+  const installManifestPath = join(installRoot, '.cursor-plugin', 'plugin.json')
+  const installHooksPath = join(installRoot, 'hooks', 'hooks-cursor.json')
+  const installedPlugin = safeJson(installManifestPath) || {}
+  const projectionManifest = normalizeText(safeRead(projectionManifestPath) || '')
+  const projectionHooks = normalizeText(safeRead(projectionHooksPath) || '')
+  const installManifest = normalizeText(safeRead(installManifestPath) || '')
+  const installHooks = normalizeText(safeRead(installHooksPath) || '')
+  const checks = {
+    homeLink: safeRealTarget(join(cursorDir, 'helloagents')) === runtime.pkgRoot,
+    standbyHooksFile: JSON.stringify(actualHooks).includes('helloagents'),
+    standbyHooksMatch: managedHooksMatch(actualHooks.hooks || actualHooks, expectedHooks),
+    globalPluginRoot: existsSync(projectionRoot),
+    globalPluginManifest: existsSync(projectionManifestPath),
+    globalPluginHooks: existsSync(projectionHooksPath),
+    globalPluginInstall: existsSync(installRoot),
+    globalPluginInstallManifest: existsSync(installManifestPath),
+    globalPluginInstallHooks: existsSync(installHooksPath),
+    globalPluginInstalled: installedPlugin.name === 'helloagents' || existsSync(installManifestPath),
+    globalPluginSyncMatch: Boolean(projectionManifest && projectionHooks)
+      && projectionManifest === installManifest
+      && projectionHooks === installHooks,
+  }
+
+  const issues = []
+  const notes = []
+  if (trackedMode !== 'none' && detectedMode !== 'none' && trackedMode !== detectedMode) {
+    issues.push(buildDoctorIssue('tracked-mode-mismatch', '记录模式与检测模式不一致', 'Tracked mode does not match detected mode'))
+  }
+  if (detectedMode === 'standby') {
+    if (!checks.homeLink) issues.push(buildDoctorIssue('standby-link-missing', 'standby Cursor home 链接缺失或未指向稳定运行根目录', 'Standby Cursor home link is missing or points to a different runtime root'))
+    if (!checks.standbyHooksFile) issues.push(buildDoctorIssue('standby-hooks-missing', 'standby Cursor hooks.json 缺少 HelloAGENTS hooks', 'Standby Cursor hooks.json is missing HelloAGENTS hooks'))
+    if (checks.standbyHooksFile && !checks.standbyHooksMatch) issues.push(buildDoctorIssue('standby-hooks-drift', 'standby Cursor hooks 与当前 hooks 配置不一致', 'Standby Cursor hooks differ from the current hook configuration'))
+  }
+  if (detectedMode === 'global') {
+    if (!checks.globalPluginRoot) issues.push(buildDoctorIssue('global-plugin-root-missing', 'global Cursor 插件投影缺失', 'Global Cursor plugin projection is missing'))
+    if (!checks.globalPluginManifest) issues.push(buildDoctorIssue('global-plugin-manifest-missing', 'global Cursor .cursor-plugin/plugin.json 缺失', 'Global Cursor .cursor-plugin/plugin.json is missing'))
+    if (!checks.globalPluginHooks) issues.push(buildDoctorIssue('global-plugin-hooks-missing', 'global Cursor hooks-cursor.json 缺失', 'Global Cursor hooks-cursor.json is missing'))
+    if (!checks.globalPluginInstall) issues.push(buildDoctorIssue('global-plugin-install-missing', 'global Cursor 本地插件安装目录缺失', 'Global Cursor local plugin install directory is missing'))
+    if (!checks.globalPluginInstallManifest) issues.push(buildDoctorIssue('global-plugin-install-manifest-missing', 'global Cursor 安装目录缺少 .cursor-plugin/plugin.json', 'Global Cursor install directory is missing .cursor-plugin/plugin.json'))
+    if (!checks.globalPluginInstallHooks) issues.push(buildDoctorIssue('global-plugin-install-hooks-missing', 'global Cursor 安装目录缺少 hooks-cursor.json', 'Global Cursor install directory is missing hooks-cursor.json'))
+    if (!checks.globalPluginInstalled) issues.push(buildDoctorIssue('global-plugin-missing', 'global Cursor 本地插件未安装', 'Global Cursor local plugin is not installed'))
+    if (checks.globalPluginInstall && checks.globalPluginInstallManifest && checks.globalPluginInstallHooks && !checks.globalPluginSyncMatch) {
+      issues.push(buildDoctorIssue('global-plugin-sync-drift', 'global Cursor 安装目录内容与受管投影不一致', 'Global Cursor install directory content differs from the managed projection'))
+    }
+    if (checks.homeLink || checks.standbyHooksFile) {
+      issues.push(buildDoctorIssue('global-standby-residue', 'global 模式下仍残留 standby 注入/链接', 'Standby injections or links still remain while the host is detected as global'))
+    }
+  } else if (trackedMode === 'global') {
+    notes.push(runtime.msg(
+      'Cursor 的 global 模式使用本地插件目录 `~/.cursor/plugins/local/helloagents`；doctor 会检查受管投影、安装目录内容同步情况与 standby 残留。',
+      'Cursor global mode uses the local plugin directory `~/.cursor/plugins/local/helloagents`; doctor checks the managed projection, install-directory sync, and standby residue.',
+    ))
+  }
+  if (trackedMode === 'none' && detectedMode !== 'none') {
+    issues.push(buildDoctorIssue('untracked-managed-state', '检测到受管状态，但配置中未记录该 CLI 模式', 'Managed state detected but this CLI mode is not tracked in config'))
+  }
+  if (trackedMode !== 'none' && detectedMode === 'none' && trackedMode !== 'global') {
+    issues.push(buildDoctorIssue('tracked-state-missing', '配置记录该 CLI 已安装，但未检测到对应的受管文件或配置', 'Config says this CLI is installed, but no managed artifacts were detected'))
+  }
+
+  const status = summarizeDoctorStatus(issues, { host, trackedMode, detectedMode })
+  return { host, label: runtime.getHostLabel(host), trackedMode, detectedMode, status, checks, issues, notes, suggestedFix: suggestDoctorFix(host, status, trackedMode) }
+}
+
+function inspectGrokDoctor(settings) {
+  const host = 'grok'
+  const trackedMode = normalizeDoctorMode(runtime.getTrackedHostMode(settings, host))
+  const detectedMode = normalizeDoctorMode(runtime.detectHostMode(host))
+  const grokDir = join(runtime.home, '.grok')
+  const registry = safeJson(join(grokDir, 'installed-plugins', 'registry.json')) || {}
+  const configText = safeRead(join(grokDir, 'config.toml')) || ''
+  const expectedHooks = readExpectedHooks('hooks-grok.json', '${GROK_PLUGIN_ROOT}')
+  const marketplaceRoot = getGrokMarketplaceRoot(runtime.home)
+  const marketplacePluginRoot = join(marketplaceRoot, 'plugins', GROK_PLUGIN_NAME)
+  const actualHooks = safeJson(join(grokDir, 'hooks', GROK_STANDBY_HOOK_FILE)) || {}
+  const checks = {
+    carrierMarker: (safeRead(join(grokDir, 'AGENTS.md')) || '').includes('HELLOAGENTS_START'),
+    carrierContentMatch: extractManagedCarrierContent(join(grokDir, 'AGENTS.md'))
+      === readExpectedCarrierContent('bootstrap-lite.md', settings),
+    homeLink: safeRealTarget(join(grokDir, 'helloagents')) === runtime.pkgRoot,
+    standbyHooksFile: JSON.stringify(actualHooks).includes('helloagents'),
+    standbyHooksMatch: managedHooksMatch(actualHooks.hooks || actualHooks, expectedHooks),
+    globalMarketplaceRoot: existsSync(marketplaceRoot),
+    globalMarketplaceCatalog: existsSync(join(marketplaceRoot, '.grok-plugin', 'marketplace.json')),
+    globalMarketplaceIndex: existsSync(join(marketplaceRoot, '.grok-plugin', 'plugin-index.json')),
+    globalPluginPayload: existsSync(marketplacePluginRoot),
+    globalPluginHooks: existsSync(join(marketplacePluginRoot, 'hooks', 'hooks.json')),
+    globalMarketplaceConfigured: textIncludesNormalizedPath(configText, marketplaceRoot),
+    globalPluginInstalled: hasRegistryPlugin(registry, GROK_PLUGIN_NAME, marketplacePluginRoot),
+    globalPluginEnabled: /\[plugins\][\s\S]*enabled\s*=\s*\[[^\]]*["']helloagents["']/i.test(configText),
+  }
+
+  const issues = []
+  const notes = []
+  if (trackedMode !== 'none' && detectedMode !== 'none' && trackedMode !== detectedMode) {
+    issues.push(buildDoctorIssue('tracked-mode-mismatch', '记录模式与检测模式不一致', 'Tracked mode does not match detected mode'))
+  }
+  if (detectedMode === 'standby') {
+    if (!checks.carrierMarker) issues.push(buildDoctorIssue('standby-carrier-missing', 'standby 规则文件缺少 HELLOAGENTS 标记', 'Standby carrier is missing the HELLOAGENTS marker'))
+    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby 规则文件内容与当前标准模式规则不一致', 'Standby carrier content differs from the current standby rules'))
+    if (!checks.homeLink) issues.push(buildDoctorIssue('standby-link-missing', 'standby home 链接缺失或未指向稳定运行根目录', 'Standby home link is missing or points to a different runtime root'))
+    if (!checks.standbyHooksFile) issues.push(buildDoctorIssue('standby-hooks-missing', 'standby Grok hooks 文件缺失', 'Standby Grok hooks file is missing'))
+    if (checks.standbyHooksFile && !checks.standbyHooksMatch) issues.push(buildDoctorIssue('standby-hooks-drift', 'standby Grok hooks 与当前 hooks 配置不一致', 'Standby Grok hooks differ from the current hook configuration'))
+  }
+  if (detectedMode === 'global') {
+    if (!checks.globalMarketplaceRoot) issues.push(buildDoctorIssue('global-marketplace-root-missing', 'global marketplace 投影缺失', 'Global marketplace projection is missing'))
+    if (!checks.globalMarketplaceCatalog) issues.push(buildDoctorIssue('global-marketplace-catalog-missing', 'global marketplace catalog 缺失', 'Global marketplace catalog is missing'))
+    if (!checks.globalMarketplaceIndex) issues.push(buildDoctorIssue('global-marketplace-index-missing', 'global marketplace plugin-index 缺失', 'Global marketplace plugin-index is missing'))
+    if (!checks.globalPluginPayload) issues.push(buildDoctorIssue('global-plugin-payload-missing', 'global Grok 插件投影缺失', 'Global Grok plugin payload is missing'))
+    if (!checks.globalPluginHooks) issues.push(buildDoctorIssue('global-plugin-hooks-missing', 'global Grok hooks.json 缺失', 'Global Grok hooks.json is missing'))
+    if (!checks.globalPluginInstalled) issues.push(buildDoctorIssue('global-plugin-missing', 'global Grok 插件未安装', 'Global Grok plugin is not installed'))
+    if (!checks.globalMarketplaceConfigured) issues.push(buildDoctorIssue('global-marketplace-config-missing', 'global marketplace 来源未写入 ~/.grok/config.toml', 'Global marketplace source is not written to ~/.grok/config.toml'))
+    if (!checks.globalPluginEnabled) issues.push(buildDoctorIssue('global-plugin-disabled', 'global Grok 插件未在 ~/.grok/config.toml 中启用', 'Global Grok plugin is not enabled in ~/.grok/config.toml'))
+    if (checks.carrierMarker || checks.homeLink || checks.standbyHooksFile) {
+      issues.push(buildDoctorIssue('global-standby-residue', 'global 模式下仍残留 standby 注入/链接', 'Standby injections or links still remain while the host is detected as global'))
+    }
+  }
+  if (runtime.detectHostMode('claude') !== 'none') {
+    notes.push(runtime.msg(
+      '检测到 Claude Code 侧也存在受管配置。Grok 默认会扫描 Claude 兼容载体，若两边同时开启，可能出现规则重复加载。',
+      'Managed Claude Code artifacts were also detected. Grok scans Claude compatibility carriers by default, so enabling both sides can lead to duplicated rule loading.',
+    ))
+  }
+  if (trackedMode === 'none' && detectedMode !== 'none') {
+    issues.push(buildDoctorIssue('untracked-managed-state', '检测到受管状态，但配置中未记录该 CLI 模式', 'Managed state detected but this CLI mode is not tracked in config'))
+  }
+  if (trackedMode !== 'none' && detectedMode === 'none') {
+    issues.push(buildDoctorIssue('tracked-state-missing', '配置记录该 CLI 已安装，但未检测到对应的受管文件或配置', 'Config says this CLI is installed, but no managed artifacts were detected'))
+  }
+
+  const status = summarizeDoctorStatus(issues, { host, trackedMode, detectedMode })
+  return { host, label: runtime.getHostLabel(host), trackedMode, detectedMode, status, checks, issues, notes, suggestedFix: suggestDoctorFix(host, status, trackedMode) }
+}
+
 function inspectGeminiDoctor(settings) {
   const host = 'gemini'
   const trackedMode = normalizeDoctorMode(runtime.getTrackedHostMode(settings, host))
@@ -270,13 +438,15 @@ function parseDoctorArgs(args) {
 
 function inspectDoctorHost(host, settings) {
   if (host === 'claude') return inspectClaudeDoctor(settings)
+  if (host === 'cursor') return inspectCursorDoctor(settings)
   if (host === 'gemini') return inspectGeminiDoctor(settings)
+  if (host === 'grok') return inspectGrokDoctor(settings)
   return inspectCodexDoctorImpl(runtime, settings)
 }
 
 function buildDoctorReport(host) {
   const settings = runtime.readSettings(true)
-  const hosts = host === 'all' ? ['claude', 'gemini', 'codex'] : [host]
+  const hosts = host === 'all' ? ['claude', 'gemini', 'grok', 'cursor', 'codex'] : [host]
   const reports = hosts.map((target) => inspectDoctorHost(target, settings))
   const summary = reports.reduce((acc, report) => {
     acc[report.status] = (acc[report.status] || 0) + 1

package/scripts/cli-grok.mjs

@@ -0,0 +1,54 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+import {
+  createLink,
+  ensureDir,
+  injectMarkedContent,
+  loadHooksWithCliEntry,
+  removeIfExists,
+  removeLink,
+  removeMarkedContent,
+  safeRead,
+  safeWrite,
+} from './cli-utils.mjs'
+import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs'
+
+export const GROK_STANDBY_HOOK_FILE = 'helloagents.json'
+
+function writeStandbyHooks(home, pkgRoot) {
+  const hooksData = loadHooksWithCliEntry(pkgRoot, 'hooks-grok.json', '${GROK_PLUGIN_ROOT}')
+  if (!hooksData) return false
+
+  const hooksDir = join(home, '.grok', 'hooks')
+  ensureDir(hooksDir)
+  safeWrite(join(hooksDir, GROK_STANDBY_HOOK_FILE), `${JSON.stringify(hooksData, null, 2)}\n`)
+  return true
+}
+
+export function installGrokStandby(home, pkgRoot) {
+  const grokDir = join(home, '.grok')
+  ensureDir(grokDir)
+
+  const bootstrapContent = safeRead(join(pkgRoot, 'bootstrap-lite.md'))
+  if (bootstrapContent) {
+    injectMarkedContent(
+      join(grokDir, 'AGENTS.md'),
+      buildRuntimeCarrier(bootstrapContent, readCarrierSettings(home)).trimEnd(),
+    )
+  }
+
+  createLink(pkgRoot, join(grokDir, 'helloagents'))
+  writeStandbyHooks(home, pkgRoot)
+  return true
+}
+
+export function uninstallGrokStandby(home) {
+  const grokDir = join(home, '.grok')
+  if (!existsSync(grokDir)) return false
+
+  removeMarkedContent(join(grokDir, 'AGENTS.md'))
+  removeLink(join(grokDir, 'helloagents'))
+  removeIfExists(join(grokDir, 'hooks', GROK_STANDBY_HOOK_FILE))
+  return true
+}

package/scripts/cli-host-detect.mjs

@@ -6,11 +6,19 @@ import {
   CODEX_PLUGIN_KEY,
   CODEX_PLUGIN_NAME,
 } from './cli-codex.mjs'
-import { getGeminiExtensionRoot, getStableRuntimeRoot } from './cli-runtime-root.mjs'
+import {
+  getCursorInstallRoot,
+  getCursorPluginRoot,
+  GROK_PLUGIN_NAME,
+  getGeminiExtensionRoot,
+  getGrokMarketplaceRoot,
+  getStableRuntimeRoot,
+} from './cli-runtime-root.mjs'
 import { safeJson, safeRead } from './cli-utils.mjs'
 
 const CLAUDE_PLUGIN = 'helloagents@helloagents'
 const GEMINI_EXTENSION = 'helloagents'
+const GROK_STANDBY_HOOK_FILE = 'helloagents.json'
 
 const HOST_ALIASES = new Map([
   ['all', 'all'],
@@ -19,6 +27,10 @@ const HOST_ALIASES = new Map([
   ['claude-code', 'claude'],
   ['gemini', 'gemini'],
   ['gemini-cli', 'gemini'],
+  ['grok', 'grok'],
+  ['grok-build', 'grok'],
+  ['cursor', 'cursor'],
+  ['cursor-cli', 'cursor'],
   ['codex', 'codex'],
   ['codex-cli', 'codex'],
 ])
@@ -59,6 +71,19 @@ function hasEnabledPlugin(enabledPlugins, pluginName) {
   return false
 }
 
+function hasHelloagentsHookFile(filePath) {
+  return JSON.stringify(safeJson(filePath) || {}).includes('helloagents')
+}
+
+function grokRegistryHasManagedPlugin(registry = {}, expectedSource = '') {
+  const normalizedExpectedSource = normalizePath(expectedSource)
+  return Object.values(registry?.repos || {}).some((repo) => {
+    if (!repo?.plugins?.[GROK_PLUGIN_NAME]) return false
+    if (!normalizedExpectedSource) return true
+    return normalizePath(repo?.kind?.source_path || '') === normalizedExpectedSource
+  })
+}
+
 function detectClaudeMode(home) {
   const claudeDir = join(home, '.claude')
   const settings = safeJson(join(claudeDir, 'settings.json')) || {}
@@ -123,6 +148,43 @@ function detectCodexMode(home) {
   return ''
 }
 
+function detectCursorMode(home) {
+  const cursorDir = join(home, '.cursor')
+  const projectionRoot = safeRealTarget(getCursorPluginRoot(home)) || normalizePath(getCursorPluginRoot(home))
+  const installRoot = getCursorInstallRoot(home)
+  const installedPlugin = safeJson(join(installRoot, '.cursor-plugin', 'plugin.json')) || {}
+  if (
+    existsSync(installRoot)
+    && (safeRealTarget(installRoot) === projectionRoot || installedPlugin.name === 'helloagents')
+  ) {
+    return 'global'
+  }
+  if (
+    existsSync(join(cursorDir, 'helloagents'))
+    || hasHelloagentsHookFile(join(cursorDir, 'hooks.json'))
+  ) {
+    return 'standby'
+  }
+  return ''
+}
+
+function detectGrokMode(home) {
+  const grokDir = join(home, '.grok')
+  const registry = safeJson(join(grokDir, 'installed-plugins', 'registry.json')) || {}
+  const marketplacePluginRoot = join(getGrokMarketplaceRoot(home), 'plugins', GROK_PLUGIN_NAME)
+  if (grokRegistryHasManagedPlugin(registry, marketplacePluginRoot)) {
+    return 'global'
+  }
+  if (
+    existsSync(join(grokDir, 'helloagents'))
+    || hasHelloagentsMarker(join(grokDir, 'AGENTS.md'))
+    || hasHelloagentsHookFile(join(grokDir, 'hooks', GROK_STANDBY_HOOK_FILE))
+  ) {
+    return 'standby'
+  }
+  return ''
+}
+
 export function normalizeHost(value = '') {
   return HOST_ALIASES.get(String(value || '').toLowerCase()) || ''
 }
@@ -130,6 +192,8 @@ export function normalizeHost(value = '') {
 export function getHostLabel(host) {
   if (host === 'claude') return 'Claude Code'
   if (host === 'gemini') return 'Gemini CLI'
+  if (host === 'grok') return 'Grok Build'
+  if (host === 'cursor') return 'Cursor'
   if (host === 'codex') return 'Codex CLI'
   return 'All CLIs'
 }
@@ -137,6 +201,8 @@ export function getHostLabel(host) {
 export function detectHostMode(host, runtime) {
   if (host === 'claude') return detectClaudeMode(runtime.home)
   if (host === 'gemini') return detectGeminiMode(runtime.home)
+  if (host === 'grok') return detectGrokMode(runtime.home)
+  if (host === 'cursor') return detectCursorMode(runtime.home)
   if (host === 'codex') return detectCodexMode(runtime.home)
   return ''
 }

package/scripts/cli-hosts.mjs

@@ -12,6 +12,8 @@ import {
   loadHooksWithCliEntry,
 } from './cli-utils.mjs';
 import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs';
+import { installCursorStandby, uninstallCursorStandby } from './cli-cursor.mjs';
+import { installGrokStandby, uninstallGrokStandby } from './cli-grok.mjs';
 
 export function installClaudeStandby(home, pkgRoot) {
   const claudeDir = join(home, '.claude');
@@ -81,3 +83,6 @@ export function uninstallGeminiStandby(home) {
 
   return true;
 }
+
+export { installGrokStandby, uninstallGrokStandby };
+export { installCursorStandby, uninstallCursorStandby };