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.20] - 2026-08-15
+
+### 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.19] - 2026-08-15
 
 ### Changed

README-zh.md

@@ -439,7 +439,7 @@ comet eval ./my-skill --suite langsmith --html
 
 ## 支持平台
 
-`comet init` 支持 34 个 AI 编码平台：
+`comet init` 支持 35 个 AI 编码平台：
 
 <details>
 <summary>查看完整平台列表</summary>
@@ -463,6 +463,7 @@ comet eval ./my-skill --suite langsmith --html
 | ForgeCode          | `.forge/`     | Trae          | `.trae/`     |
 | Trae CN            | `.trae-cn/`   | ZCode         | `.zcode/`    |
 | MimoCode           | `.mimocode/`  | CoStrict      | `.cospec/`   |
+| Grok               | `.agents/`    |               |              |
 
 </details>
 

README.md

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

assets/manifest.json

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

domains/comet-entry/hook-adapter.ts

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

domains/integrations/superpowers.ts

@@ -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',

domains/skill/platform-inspect.ts

@@ -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 };

domains/skill/platform-install.ts

@@ -1451,6 +1451,14 @@ async function readSettingsJsonObject(
   });
 }
 
+/** Grok aliases Write/Edit to search_replace, but its native write tool is a separate name. */
+function resolveClaudeCodeHookMatcher(platformId: string, matcher: string): string {
+  if (platformId === 'grok' && matcher === 'Write|Edit') {
+    return 'Write|Edit|write|search_replace';
+  }
+  return matcher;
+}
+
 /**
  * Claude-shaped JSON format used by Claude Code, Codex, and Amazon Q.
  * Defaults to settings.local.json; platform metadata may override the filename.
@@ -1476,10 +1484,11 @@ async function installClaudeCodeHooks(
   const matcherGroups: Record<string, Array<{ type: string; command: string }>> = {};
   for (const [scriptRelPath, config] of Object.entries(hooksConfig)) {
     const command = buildHookCommand(baseDir, skillsDir, scriptRelPath, context);
-    if (!matcherGroups[config.matcher]) {
-      matcherGroups[config.matcher] = [];
+    const matcher = resolveClaudeCodeHookMatcher(context.platformId, config.matcher);
+    if (!matcherGroups[matcher]) {
+      matcherGroups[matcher] = [];
     }
-    matcherGroups[config.matcher].push({ type: 'command', command });
+    matcherGroups[matcher].push({ type: 'command', command });
   }
 
   const newEntries: ClaudeCodeHookEntry[] = Object.entries(matcherGroups).map(
@@ -2134,6 +2143,7 @@ export {
   computeRuleDestPath,
   formatRuleContent,
   isManagedHookCommand,
+  resolveClaudeCodeHookMatcher,
   removeManagedCopilotHookEntries,
   buildHookCommand,
   removeManagedHooksFromJsonFile,

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpamis/comet",
-  "version": "0.4.0-beta.19",
+  "version": "0.4.0-beta.20",
   "description": "Agent Skill Harness For Turning Ideas Into Evaluated Workflows",
   "keywords": [
     "comet",