feat: add Grok as a first-class Comet platform

Install Grok Skills into the shared .agents root, keep rules and the Hook
Router under .grok, and recognize Grok's native write/search_replace tools.

Author: mouyase

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to @rpamis/comet will be documented in this file.
 
+## What's Changed [0.4.0-beta.19] - 2026-08-13
+
+### Added
+
+- **Grok platform support**: `comet init`, `comet update`, `comet doctor`, and `comet uninstall` now treat Grok as a first-class host. Project Skills share the `.agents` root with Codex, while rules and the Hook Router live under `.grok/rules/` and `.grok/hooks/comet.json`. The Router recognizes `--platform grok` and matches Grok's native `write` / `search_replace` tools.
+
 ## What's Changed [0.4.0-beta.18] - 2026-08-12
 
 ### Fixed

README-zh.md

@@ -414,7 +414,7 @@ comet eval ./generated-skill/comet/eval.yaml --suite langsmith --html
 
 ## 支持平台
 
-`comet init` 支持 33 个 AI 编码平台：
+`comet init` 支持 34 个 AI 编码平台：
 
 <details>
 <summary>查看完整平台列表</summary>
@@ -437,7 +437,7 @@ comet eval ./generated-skill/comet/eval.yaml --suite langsmith --html
 | Antigravity 2.0    | `.agents/`    | Bob Shell     | `.bob/`      |
 | ForgeCode          | `.forge/`     | Trae          | `.trae/`     |
 | Trae CN            | `.trae-cn/`   | ZCode         | `.zcode/`    |
-| MimoCode           | `.mimocode/`  |               |              |
+| MimoCode           | `.mimocode/`  | Grok          | `.agents/`   |
 
 </details>
 

README.md

@@ -443,7 +443,7 @@ does not expand the backend command list; see the [Skill creation guide](docs/op
 
 ## Supported Platforms
 
-`comet init` supports 33 AI coding platforms:
+`comet init` supports 34 AI coding platforms:
 
 <details>
 <summary>View full platform list</summary>
@@ -466,7 +466,7 @@ does not expand the backend command list; see the [Skill creation guide](docs/op
 | Antigravity 2.0    | `.agents/`    | Bob Shell     | `.bob/`      |
 | ForgeCode          | `.forge/`     | Trae          | `.trae/`     |
 | Trae CN            | `.trae-cn/`   | ZCode         | `.zcode/`    |
-| MimoCode           | `.mimocode/`  |               |              |
+| MimoCode           | `.mimocode/`  | Grok          | `.agents/`   |
 
 </details>
 

assets/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.4.0-beta.18",
+  "version": "0.4.0-beta.19",
   "skills": [
     "comet/SKILL.md",
     "comet/agents/openai.yaml",

assets/skills/comet-native/scripts/comet-native-hook-guard.mjs

@@ -11,6 +11,7 @@ const WRITE_TOOL_NAMES = new Set([
   'edit',
   'editfile',
   'patch',
+  'searchreplace',
   'strreplaceeditor',
   'write',
   'writefile',
@@ -45,6 +46,7 @@ export const COMET_HOOK_PLATFORM_IDS = new Set([
   'qoder',
   'trae',
   'trae-cn',
+  'grok',
 ]);
 
 function isRecord(value: unknown): value is Record<string, unknown> {

assets/skills/comet-native/scripts/comet-native-runtime.mjs

@@ -18,6 +18,8 @@ const SKILLS_AGENT_MAP: Record<string, string | null> = {
   continue: 'continue',
   'github-copilot': 'github-copilot',
   gemini: 'gemini-cli',
+  // Grok reads Superpowers from the shared .agents root that Codex owns.
+  grok: 'codex',
   'amazon-q': 'universal',
   qwen: 'qwen-code',
   kilocode: 'kilo',

assets/skills/comet/scripts/comet-hook-router.mjs

@@ -12,6 +12,7 @@ import {
   computeRuleDestPath,
   isManagedHookCommand,
   readManifest,
+  resolveClaudeCodeHookMatcher,
 } from './platform-install.js';
 import { readJsonObjectFile } from './json-object.js';
 import type { InitWorkflowSelection } from '../comet-entry/types.js';
@@ -392,14 +393,20 @@ export async function inspectCometHooksForPlatform(
         path.join(platformBase, platform.hookConfigFile ?? 'settings.local.json'),
         expectedHooks,
         (config) => collectGroupedCommands(config, 'PreToolUse'),
-        (config, expected) => countGroupedHookMatches(config, 'PreToolUse', expected),
+        (config, expected) =>
+          countGroupedHookMatches(config, 'PreToolUse', expected, (matcher) =>
+            resolveClaudeCodeHookMatcher(platform.id, matcher),
+          ),
       );
       for (const legacyFile of platform.legacyHookConfigFiles ?? []) {
         const legacy = await inspectSingleHookJson(
           path.join(platformBase, legacyFile),
           expectedHooks,
           (config) => collectGroupedCommands(config, 'PreToolUse'),
-          (config, expected) => countGroupedHookMatches(config, 'PreToolUse', expected),
+          (config, expected) =>
+            countGroupedHookMatches(config, 'PreToolUse', expected, (matcher) =>
+              resolveClaudeCodeHookMatcher(platform.id, matcher),
+            ),
         );
         if (legacy.error) {
           inspection = { ...inspection, present: false, error: legacy.error };