feat: add Trae hook support

Author: googs1025

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.17] - 2026-08-06
+
+### Added
+
+- **Trae Hook support**: `comet init`, `comet update`, `comet doctor`, and `comet uninstall` now support managed Hook Router entries for Trae and Trae CN, using Trae's official project and global `hooks.json` locations while preserving user-owned Hook configuration.
+
 ## What's Changed [0.4.0-beta.16] - 2026-08-05
 
 ### Fixed

assets/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.4.0-beta.16",
+  "version": "0.4.0-beta.17",
   "skills": [
     "comet/SKILL.md",
     "comet-classic/SKILL.md",

domains/bundle/bundle-platform.ts

@@ -118,6 +118,7 @@ function hookDestination(target: BundlePlatformTarget, hookId: string): string |
     case 'gemini':
       return path.join(platformRoot, 'settings.json');
     case 'windsurf':
+    case 'trae':
       return path.join(platformRoot, 'hooks.json');
     case 'copilot':
       return path.join(platformRoot, 'hooks', `${hookId}.json`);
@@ -291,6 +292,18 @@ async function applyHookInstallFile(file: PlatformInstallFile): Promise<void> {
       await writeFile(file.destination, JSON.stringify(settings, null, 2) + '\n');
       return;
     }
+    case 'trae': {
+      hooks.PreToolUse = mergeCommandHookGroup(
+        asHookGroups(hooks.PreToolUse),
+        matcher,
+        { ...commandHook, timeout: 30 },
+        operation.command,
+      );
+      settings.version = settings.version ?? 1;
+      settings.hooks = hooks;
+      await writeFile(file.destination, JSON.stringify(settings, null, 2) + '\n');
+      return;
+    }
     case 'gemini': {
       const geminiMatcher = matcher === 'Write|Edit' ? 'write_file|edit_file' : matcher;
       hooks.BeforeTool = mergeCommandHookGroup(

domains/bundle/types.ts

@@ -334,7 +334,8 @@ export interface PlatformInstallFile {
           | 'qwen'
           | 'kiro'
           | 'qoder'
-          | 'codebuddy';
+          | 'codebuddy'
+          | 'trae';
         event: NormalizedHook['event'];
         matcher?: string;
         command: string;

domains/skill/platform-inspect.ts

@@ -142,6 +142,34 @@ function countGroupedHookMatches(
   }, 0);
 }
 
+function countTraeHookMatches(
+  config: Record<string, unknown>,
+  expected: ExpectedHookDescriptor,
+): number {
+  const hooks = config.hooks;
+  if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks)) return 0;
+  const groups = (hooks as Record<string, unknown>).PreToolUse;
+  if (!Array.isArray(groups)) return 0;
+  return groups.reduce((count, group) => {
+    if (!group || typeof group !== 'object' || Array.isArray(group)) return count;
+    const record = group as Record<string, unknown>;
+    if (record.matcher !== expected.matcher || !Array.isArray(record.hooks)) return count;
+    return (
+      count +
+      record.hooks.filter(
+        (handler) =>
+          handler !== null &&
+          typeof handler === 'object' &&
+          !Array.isArray(handler) &&
+          (handler as Record<string, unknown>).type === 'command' &&
+          (handler as Record<string, unknown>).command === expected.command &&
+          typeof (handler as Record<string, unknown>).timeout === 'number' &&
+          ((handler as Record<string, unknown>).timeout as number) > 0,
+      ).length
+    );
+  }, 0);
+}
+
 function collectCommandArray(config: Record<string, unknown>, groupName: string): unknown[] {
   const hooks = config.hooks;
   if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks)) return [];
@@ -440,6 +468,14 @@ export async function inspectCometHooksForPlatform(
         countWindsurfHookMatches,
       );
       break;
+    case 'trae':
+      inspection = await inspectSingleHookJson(
+        path.join(platformBase, 'hooks.json'),
+        expectedHooks,
+        (config) => collectGroupedCommands(config, 'PreToolUse'),
+        countTraeHookMatches,
+      );
+      break;
     case 'copilot':
       inspection = await inspectSingleHookJson(
         path.join(platformBase, 'hooks', 'comet-guard.json'),

domains/skill/platform-install.ts

@@ -1006,6 +1006,7 @@ ${content}`;
  *   'windsurf' — hooks.json with pre_write_code array
  *   'copilot' — hooks/*.json with preToolUse
  *   'kiro' — hooks/*.kiro.hook JSON files
+ *   'trae' — hooks.json with version and PreToolUse grouped command hooks
  */
 async function installCometHooksForPlatform(
   baseDir: string,
@@ -1023,7 +1024,7 @@ async function installCometHooksForPlatform(
     };
   }
 
-  if (scope === 'global') {
+  if (scope === 'global' && platform.hookFormat !== 'trae') {
     return {
       status: 'skipped',
       reason: 'blocking Hooks are project-scoped',
@@ -1114,6 +1115,15 @@ async function installCometHooksForPlatform(
           platformId: platform.id,
           scope,
         });
+      case 'trae':
+        return await installTraeHooks(
+          baseDir,
+          platformBase,
+          skillsDir,
+          hooksConfig,
+          platform.name,
+          { platformId: platform.id, scope },
+        );
       default:
         return { status: 'failed', reason: `unsupported hook format: ${hookFormat}` };
     }
@@ -1542,6 +1552,53 @@ async function installWindsurfHooks(
   return { status: 'installed' };
 }
 
+/**
+ * Trae format:
+ * Writes to hooks.json with { version: 1, hooks: { PreToolUse: [{ matcher, hooks: [{ type, command, timeout }] }] } }
+ */
+async function installTraeHooks(
+  baseDir: string,
+  platformBase: string,
+  skillsDir: string,
+  hooksConfig: Record<string, HookConfig>,
+  platformName: string,
+  context: HookCommandContext,
+): Promise<HookInstallResult> {
+  const hooksPath = path.join(platformBase, 'hooks.json');
+  const matcherGroups: Record<
+    string,
+    Array<{ type: string; command: string; timeout: number }>
+  > = {};
+
+  for (const [scriptRelPath, config] of Object.entries(hooksConfig)) {
+    matcherGroups[config.matcher] ??= [];
+    matcherGroups[config.matcher].push({
+      type: 'command',
+      command: buildHookCommand(baseDir, skillsDir, scriptRelPath, context),
+      timeout: 30,
+    });
+  }
+
+  const preToolUseEntries = Object.entries(matcherGroups).map(([matcher, hooks]) => ({
+    matcher,
+    hooks,
+  }));
+  const hooksFile = await readSettingsJsonObject(hooksPath, platformName);
+  const existingHooks = (hooksFile.hooks as Record<string, unknown>) ?? {};
+  const existingPreToolUse = asHookGroup(existingHooks.PreToolUse);
+  const merged = mergeHookGroups(
+    existingPreToolUse,
+    preToolUseEntries,
+    managedHookScriptPaths(hooksConfig),
+  );
+
+  hooksFile.version = hooksFile.version ?? 1;
+  hooksFile.hooks = { ...existingHooks, PreToolUse: merged };
+  await ensureDir(path.dirname(hooksPath));
+  await writeFile(hooksPath, JSON.stringify(hooksFile, null, 2) + '\n', 'utf-8');
+  return { status: 'installed' };
+}
+
 /**
  * GitHub Copilot format:
  * Writes to .github/hooks/comet-guard.json with preToolUse hooks config.

domains/skill/uninstall.ts

@@ -1047,6 +1047,8 @@ async function removeCometHooksForPlatform(
         return await removeGeminiHooks(platformBase, scriptRelPaths);
       case 'windsurf':
         return await removeWindsurfHooks(platformBase, scriptRelPaths);
+      case 'trae':
+        return await removeTraeHooks(platformBase, scriptRelPaths);
       case 'copilot':
         return await removeCopilotHooks(platformBase, scriptRelPaths);
       case 'kiro':
@@ -1209,6 +1211,58 @@ async function removeWindsurfHooks(
   return { removed, failed: 0 };
 }
 
+async function removeTraeHooks(
+  platformBase: string,
+  scriptRelPaths: string[],
+): Promise<RemovalResult> {
+  const hooksPath = path.join(platformBase, 'hooks.json');
+  if (!(await fileExists(hooksPath))) return { removed: 0, failed: 0 };
+  let removed = 0;
+  const readResult = await readJsonObjectFile(hooksPath);
+  if (readResult.status === 'missing') return { removed: 0, failed: 0 };
+  if (readResult.status === 'error') return { removed: 0, failed: 1 };
+  const hooksFile = readResult.value;
+
+  const existingHooks = hooksFile.hooks as Record<string, unknown> | undefined;
+  if (!existingHooks) {
+    return { removed: 0, failed: 0 };
+  }
+
+  const existingPreToolUse = existingHooks.PreToolUse as Array<Record<string, unknown>> | undefined;
+  if (!existingPreToolUse || !Array.isArray(existingPreToolUse)) {
+    return { removed: 0, failed: 0 };
+  }
+
+  const filtered = existingPreToolUse.flatMap((group) => {
+    if (!Array.isArray(group.hooks)) return [group];
+
+    const hooksBefore = (group.hooks as Array<Record<string, unknown>>).length;
+    const hooks = (group.hooks as Array<Record<string, unknown>>).filter(
+      (hook) => !isManagedHookCommand(hook.command, scriptRelPaths),
+    );
+    removed += hooksBefore - hooks.length;
+
+    const hasUnknownMetadata = Object.keys(group).some(
+      (key) => key !== 'matcher' && key !== 'hooks',
+    );
+    if (hooks.length === 0) return hasUnknownMetadata ? [{ ...group, hooks: [] }] : [];
+    return [{ ...group, hooks }];
+  });
+
+  if (filtered.length === 0) {
+    delete existingHooks.PreToolUse;
+  } else {
+    existingHooks.PreToolUse = filtered;
+  }
+
+  if (Object.keys(existingHooks).length === 0) {
+    delete hooksFile.hooks;
+  }
+
+  await writeFile(hooksPath, JSON.stringify(hooksFile, null, 2) + '\n', 'utf-8');
+  return { removed, failed: 0 };
+}
+
 async function removeCopilotHooks(
   platformBase: string,
   scriptRelPaths: string[],

package-lock.json

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

package.json

@@ -15,6 +15,8 @@ export interface Platform {
   legacySkillsDirs?: string[];
   /** Platform configuration and hook root when it differs from the Skill root. */
   configDir?: string;
+  /** Global platform configuration and hook root when it differs from the global Skill root. */
+  globalConfigDir?: string;
   detectionPaths?: string[];
   openspecToolId: string;
   /** OpenSpec's generated tool root when it differs from Comet's canonical Skill root. */
@@ -36,7 +38,8 @@ export interface Platform {
     | 'qwen'
     | 'kiro'
     | 'qoder'
-    | 'codebuddy';
+    | 'codebuddy'
+    | 'trae';
   /** Hook config filename relative to the platform config root when it differs from the format default. */
   hookConfigFile?: string;
   /** Historical hook config filenames checked during migration and uninstall. */
@@ -63,6 +66,9 @@ export function getPlatformSkillsDirs(platform: Platform, scope: InstallScope):
 }
 
 export function getPlatformConfigDir(platform: Platform, scope: InstallScope): string {
+  if (scope === 'global' && platform.globalConfigDir) {
+    return platform.globalConfigDir;
+  }
   return platform.configDir ?? getPlatformSkillsDir(platform, scope);
 }
 
@@ -306,17 +312,23 @@ export const PLATFORMS: Platform[] = [
     openspecToolId: 'trae',
     rulesDir: 'rules',
     rulesFormat: 'md',
+    supportsHooks: true,
+    hookFormat: 'trae',
   },
   {
     id: 'trae-cn',
     name: 'Trae CN',
     skillsDir: '.trae-cn',
     globalSkillsDir: '.trae-cn',
+    configDir: '.trae',
+    globalConfigDir: '.trae-cn',
     // OpenSpec exposes Trae as one tool id; keep Comet's CN-specific install
     // directories but reuse the supported OpenSpec Trae integration.
     openspecToolId: 'trae',
     rulesDir: 'rules',
     rulesFormat: 'md',
+    supportsHooks: true,
+    hookFormat: 'trae',
   },
   {
     id: 'zcode',