@memorax/memorax-code 0.1.10 → 0.1.12

package/README.md

@@ -1,13 +1,13 @@
 # @memorax/memorax-code
 
-MemoraX Code adds persistent coding memory to Codex, Claude Code, DeepSeek
-Harness, and OpenCode.
+MemoraX Code adds persistent coding memory to Codex, Claude Code,
+CodeBuddy/WorkBuddy, DeepSeek Harness, OpenCode, and Trae.
 
 ## Requirements
 
 - Node.js 20 or newer (Node.js 24 LTS recommended) and npm.
-- At least one of Codex, Claude Code, DeepSeek Harness, OpenCode Desktop, or
-  the OpenCode CLI.
+- At least one of Codex, Claude Code, CodeBuddy/WorkBuddy, DeepSeek Harness,
+  OpenCode Desktop or CLI, or Trae.
 - Python 3 only for Repo Memory operations.
 
 ## Install
@@ -67,6 +67,9 @@ $env:Path = "$NpmGlobalBin;$env:Path"
 After the first installation, restart or refresh the detected coding agents
 before opening a new session. In Codex, enable **MemoraX Code Codex Adapter**
 from Plugins or `/plugins` if it is not already enabled.
+For Trae, open Settings and enable **Global Hooks** once before starting a new
+Trae session; setup installs the managed Hooks and Skill but cannot switch that
+Trae setting reliably.
 
 ## Verify
 

package/bin/memorax-code-setup.mjs

@@ -22,6 +22,10 @@ import { discoverDshProfiles } from "../lib/dsh-plugin-install.mjs";
 import { ensureClaudeCommandEnv } from "../lib/resolve-claude-command.mjs";
 import { ensureCodexCommandEnv } from "../lib/resolve-codex-command.mjs";
 import { defaultCodeBuddyHome, ensureCodeBuddyCommandEnv } from "../lib/resolve-codebuddy-command.mjs";
+import {
+  defaultTraeHome,
+  traeInstallationDetected,
+} from "../lib/memorax-code-trae-adapter/src/adapter-paths.mjs";
 import { reconcileSetup } from "../lib/setup-reconcile.mjs";
 import { detectSetupMemoryPreferences } from "../lib/setup-memory-preferences.mjs";
 import { ensureTrialSetupCredential } from "../lib/trial-setup.mjs";
@@ -41,11 +45,13 @@ const RED = "\x1b[31m";
 const BOLD = "\x1b[1m";
 const RESET = "\x1b[0m";
 const DSH_OPTIONAL_ENV = "MEMORAX_CODE_DSH_ADAPTER_OPTIONAL";
+const SETUP_CLIENTS = ["codex", "claude", "opencode", "codebuddy", "trae"];
 
 const skipCodexPluginInstall = truthyEnv(process.env.MEMORAX_CODE_SKIP_CODEX_PLUGIN_INSTALL);
 const skipClaudeAdapterInstall = truthyEnv(process.env.MEMORAX_CODE_SKIP_CLAUDE_ADAPTER_INSTALL);
 const skipOpenCodeAdapterInstall = truthyEnv(process.env.MEMORAX_CODE_SKIP_OPENCODE_ADAPTER_INSTALL);
 const skipCodeBuddyAdapterInstall = truthyEnv(process.env.MEMORAX_CODE_SKIP_CODEBUDDY_ADAPTER_INSTALL);
+const skipTraeAdapterInstall = truthyEnv(process.env.MEMORAX_CODE_SKIP_TRAE_ADAPTER_INSTALL);
 const updateMode = truthyEnv(process.env.MEMORAX_CODE_SETUP_UPDATE);
 const automaticUpdateMode = truthyEnv(process.env.MEMORAX_CODE_SETUP_AUTOMATIC_UPDATE);
 const setupMode = setupModeFromEnvironment(process.env.MEMORAX_CODE_SETUP_MODE);
@@ -68,8 +74,10 @@ const claudeRuntime = ensureClaudeCommandEnv();
 const claudeCommand = claudeRuntime.command;
 const codeBuddyRuntime = ensureCodeBuddyCommandEnv();
 const codeBuddyCommand = codeBuddyRuntime.command;
-const previousClients = readPersistedClientSelection();
-const existingSetup = previousClients !== undefined;
+const persistedClientSelection = readPersistedClientSelection();
+const existingSetup = persistedClientSelection !== undefined;
+const previousClients = persistedClientSelection?.selected ?? [];
+const explicitClientChoices = persistedClientSelection?.explicit ?? [];
 const persistedDshSelection = readPersistedDshSelection();
 const dshEnabledByConfig = persistedDshSelection !== false;
 let dshProfiles = [];
@@ -114,7 +122,7 @@ try {
   process.exit(1);
 }
 runCommonPreflight();
-const requestedClients = ["codex", "claude", "opencode", "codebuddy"];
+const requestedClients = SETUP_CLIENTS;
 const codexPreflight = requestedClients.includes("codex") && !skipCodexPluginInstall
   ? runCodexPreflight({
       integrationSelected: !existingSetup || previousClients.includes("codex"),
@@ -135,17 +143,33 @@ const codebuddyPreflight = requestedClients.includes("codebuddy") && !skipCodeBu
       integrationSelected: !existingSetup || previousClients.includes("codebuddy"),
     })
   : { ok: true };
+const traePreflight = requestedClients.includes("trae") && !skipTraeAdapterInstall
+  ? runTraePreflight({
+      integrationSelected: !existingSetup || previousClients.includes("trae"),
+    })
+  : { ok: true };
 const detectedClients = requestedClients.filter((client) => {
   if (client === "codex") return !skipCodexPluginInstall && codexPreflight.ok;
   if (client === "claude") return !skipClaudeAdapterInstall && claudePreflight.ok;
   if (client === "opencode") return !skipOpenCodeAdapterInstall && opencodePreflight.ok;
-  return !skipCodeBuddyAdapterInstall && codebuddyPreflight.ok;
+  if (client === "codebuddy") return !skipCodeBuddyAdapterInstall && codebuddyPreflight.ok;
+  return !skipTraeAdapterInstall && traePreflight.ok;
 });
+const newlyDetectedClients = existingSetup
+  ? detectedClients.filter((client) => !explicitClientChoices.includes(client))
+  : [];
 const selectedClients = automaticUpdateMode
-  ? previousClients
+  ? requestedClients.filter((client) => (
+      previousClients.includes(client) || newlyDetectedClients.includes(client)
+    ))
   : existingSetup
-    ? await chooseUpdateClients(previousClients, detectedClients, scriptedAnswers)
+    ? await chooseUpdateClients(previousClients, newlyDetectedClients, scriptedAnswers)
     : detectedClients;
+const clientsWithPersistedIntent = existingSetup
+  ? requestedClients.filter((client) => (
+      explicitClientChoices.includes(client) || newlyDetectedClients.includes(client)
+    ))
+  : requestedClients;
 const installClients = detectedClients.filter((client) => selectedClients.includes(client));
 if (existingSetup) {
   log(clientSelectionMessage(selectedClients, { dshSelected }));
@@ -169,7 +193,10 @@ if (requestedClients.includes("opencode") && !skipOpenCodeAdapterInstall && !ope
 if (requestedClients.includes("codebuddy") && !skipCodeBuddyAdapterInstall && !codebuddyPreflight.ok) {
   log("CodeBuddy/WorkBuddy runtime was not detected; skipping its adapter setup.");
 }
-if (writeClientSelectionConfig(selectedClients) === "failed") {
+if (requestedClients.includes("trae") && !skipTraeAdapterInstall && !traePreflight.ok) {
+  log("Trae runtime or data directory was not detected; skipping its adapter setup.");
+}
+if (writeClientSelectionConfig(selectedClients, clientsWithPersistedIntent) === "failed") {
   printPostinstallSummary("not-verified");
   process.exit(1);
 }
@@ -206,6 +233,7 @@ const codexClientEnabled = installClients.includes("codex");
 const claudeClientEnabled = installClients.includes("claude");
 const opencodeClientEnabled = installClients.includes("opencode");
 const codebuddyClientEnabled = installClients.includes("codebuddy");
+const traeClientEnabled = installClients.includes("trae");
 const codexClientNewlyEnabled = codexClientEnabled
   && existingSetup
   && !previousClients.includes("codex");
@@ -269,6 +297,11 @@ const codebuddySkipReason = setupClientSkipReason({
   selected: selectedClients.includes("codebuddy"),
   enabled: codebuddyClientEnabled,
 });
+const traeSkipReason = setupClientSkipReason({
+  explicitlySkipped: skipTraeAdapterInstall,
+  selected: selectedClients.includes("trae"),
+  enabled: traeClientEnabled,
+});
 
 const backendAndAdapters = await startBackendAndCheck({
   skipCodexAdapter,
@@ -283,6 +316,9 @@ const backendAndAdapters = await startBackendAndCheck({
   skipCodeBuddyAdapter: !codebuddyClientEnabled,
   codebuddyAdapterRequired: codebuddyClientEnabled,
   codebuddySkipReason,
+  skipTraeAdapter: !traeClientEnabled,
+  traeAdapterRequired: traeClientEnabled,
+  traeSkipReason,
 });
 const backendAndAdaptersStatus = backendAndAdapters.status;
 if (backendAndAdaptersStatus === "enabled") {
@@ -295,12 +331,15 @@ if (backendAndAdaptersStatus === "enabled") {
     dshAdapterEnabled: backendAndAdapters.dshAdapterEnabled,
     opencodeAdapterEnabled: !skipOpenCodeAdapter,
     codebuddyAdapterEnabled: codebuddyClientEnabled,
+    traeAdapterEnabled: traeClientEnabled,
+    traeGlobalHooksActivationRequired: backendAndAdapters.traeGlobalHooksActivationRequired,
   });
   printCommonCommands({
     codexAdapterEnabled: !skipCodexAdapter,
     claudeAdapterEnabled: !skipClaudeAdapter,
     opencodeAdapterEnabled: !skipOpenCodeAdapter,
     codebuddyAdapterEnabled: codebuddyClientEnabled,
+    traeAdapterEnabled: traeClientEnabled,
   });
 }
 printPostinstallSummary(
@@ -371,16 +410,15 @@ async function maybeConfigureMemoraxMemory(scriptedAnswers, {
   }
 }
 
-async function chooseUpdateClients(previousClients, detectedClients, scriptedAnswers) {
+async function chooseUpdateClients(previousClients, newlyDetectedClients, scriptedAnswers) {
   const selected = new Set(previousClients);
-  const availableDisabledClients = detectedClients.filter((client) => !selected.has(client));
-  if (availableDisabledClients.length === 0) return [...previousClients];
+  if (newlyDetectedClients.length === 0) return [...previousClients];
 
   let rl;
   try {
-    for (const client of availableDisabledClients) {
+    for (const client of newlyDetectedClients) {
       const label = clientLabel(client);
-      const question = `${label} runtime is available, but its integration is disabled in [clients]. Enable it now? [Y/n]`;
+      const question = `${label} runtime is not configured in [clients]. Enable it now? [Y/n]`;
       let answer;
       if (scriptedAnswers) {
         log(question);
@@ -399,7 +437,7 @@ async function chooseUpdateClients(previousClients, detectedClients, scriptedAns
   } finally {
     rl?.close();
   }
-  return ["codex", "claude", "opencode", "codebuddy"].filter((client) => selected.has(client));
+  return SETUP_CLIENTS.filter((client) => selected.has(client));
 }
 
 async function configureMemoraxMemoryFromAnswers(answers, detectedPreferences, {
@@ -753,12 +791,10 @@ function readPersistedClientSelection() {
   try {
     const clients = parse(readFileSync(path, "utf8"))?.clients;
     if (!clients || typeof clients !== "object" || typeof clients.codex !== "boolean" || typeof clients.claude !== "boolean") return undefined;
-    return [
-      clients.codex ? "codex" : undefined,
-      clients.claude ? "claude" : undefined,
-      clients.opencode === true ? "opencode" : undefined,
-      clients.codebuddy === true ? "codebuddy" : undefined,
-    ].filter(Boolean);
+    return {
+      selected: SETUP_CLIENTS.filter((client) => clients[client] === true),
+      explicit: SETUP_CLIENTS.filter((client) => typeof clients[client] === "boolean"),
+    };
   } catch {
     return undefined;
   }
@@ -775,22 +811,24 @@ function readPersistedDshSelection() {
   }
 }
 
-function writeClientSelectionConfig(clients) {
+function writeClientSelectionConfig(clients, configuredClients = SETUP_CLIENTS) {
   const path = memoraxCodeConfigPath();
   return updateConfigFileAtomically({
     path,
-    defaultText: setManagedClientSelection(defaultMemoraxCodeConfig(), clients),
-    transform: (text) => setManagedClientSelection(text, clients),
+    defaultText: setManagedClientSelection(defaultMemoraxCodeConfig(), clients, configuredClients),
+    transform: (text) => setManagedClientSelection(text, clients, configuredClients),
     parseToml: parse,
     warn: (message) => log(message),
   });
 }
 
-function setManagedClientSelection(text, clients) {
-  const withOpenCode = setTomlField(text, "clients", "opencode", String(clients.includes("opencode")));
-  const withClaude = setTomlField(withOpenCode, "clients", "claude", String(clients.includes("claude")));
-  const withCodeBuddy = setTomlField(withClaude, "clients", "codebuddy", String(clients.includes("codebuddy")));
-  return setTomlField(withCodeBuddy, "clients", "codex", String(clients.includes("codex")));
+function setManagedClientSelection(text, clients, configuredClients = SETUP_CLIENTS) {
+  let updated = text;
+  for (const client of ["opencode", "claude", "codebuddy", "trae", "codex"]) {
+    if (!configuredClients.includes(client)) continue;
+    updated = setTomlField(updated, "clients", client, String(clients.includes(client)));
+  }
+  return updated;
 }
 
 function writeMemoraxConfig({ userId, endpoint, outputLanguage, apiKey }) {
@@ -844,6 +882,7 @@ function defaultMemoraxCodeConfig() {
     "dsh = true # Manage the DeepSeek Harness adapter when Profiles exist.",
     "opencode = true # Manage the OpenCode adapter.",
     "codebuddy = true # Manage the CodeBuddy/WorkBuddy adapter.",
+    "trae = true # Manage the Trae adapter.",
     "",
     "# MemoraX remote-memory connection.",
     "[memorax]",
@@ -893,6 +932,10 @@ function defaultMemoraxCodeConfig() {
     "enabled = true # Enable local CodeBuddy session memory trace collection.",
     "capture_content = true # Store content in local CodeBuddy trace events.",
     "",
+    "[trace.trae]",
+    "enabled = true # Enable local Trae session memory trace collection.",
+    "capture_content = true # Store content in local Trae trace events.",
+    "",
   ].join("\n");
 }
 
@@ -965,6 +1008,9 @@ function runCommonPreflight() {
   if (skipCodeBuddyAdapterInstall) {
     log("CodeBuddy/WorkBuddy adapter setup is disabled for this setup; other client setup can still continue.");
   }
+  if (skipTraeAdapterInstall) {
+    log("Trae adapter setup is disabled for this setup; other client setup can still continue.");
+  }
   return {};
 }
 
@@ -1053,6 +1099,18 @@ function runCodeBuddyPreflight({ integrationSelected = true } = {}) {
   return { ok: true };
 }
 
+function runTraePreflight({ integrationSelected = true } = {}) {
+  const home = defaultTraeHome();
+  const detected = traeInstallationDetected();
+  log(`Trae data directory: ${existsSync(home) ? `found (${home})` : "not detected"}`);
+  log(`Trae application: ${detected ? "detected" : "not detected"}`);
+  if (!detected) return { ok: false };
+  log(integrationSelected
+    ? "Keeping Trae provider settings unchanged and installing the shared memory Global Hooks and Skill."
+    : "Keeping Trae provider settings unchanged while checking whether to enable its integration.");
+  return { ok: true };
+}
+
 function installedPluginCache() {
   for (const marketplaceName of [CLI_MARKETPLACE_NAME, PERSONAL_MARKETPLACE_NAME]) {
     const versions = installedPluginCacheVersions(marketplaceName);
@@ -1121,6 +1179,9 @@ async function startBackendAndCheck({
   skipCodeBuddyAdapter = false,
   codebuddyAdapterRequired = !skipCodeBuddyAdapter,
   codebuddySkipReason,
+  skipTraeAdapter = false,
+  traeAdapterRequired = !skipTraeAdapter,
+  traeSkipReason,
 } = {}) {
   const adapterFlags = clientLifecycleFlags({ clientMode });
   const startArgs = ["start", ...adapterFlags];
@@ -1142,6 +1203,7 @@ async function startBackendAndCheck({
       claudeAdapterRequired,
       opencodeAdapterRequired,
       codebuddyAdapterRequired,
+      traeAdapterRequired,
     }),
     onEvent: (event) => {
       if (event.type === "start" && event.attempt === 1) {
@@ -1174,6 +1236,8 @@ async function startBackendAndCheck({
           opencodeSkipReason,
           skipCodeBuddyAdapter,
           codebuddySkipReason,
+          skipTraeAdapter,
+          traeSkipReason,
         });
       }
     },
@@ -1186,6 +1250,9 @@ async function startBackendAndCheck({
     dshAdapterUnavailable: result.status === "enabled" && statusResult
       ? dshAdapterUnavailable(statusResult)
       : false,
+    traeGlobalHooksActivationRequired: result.status === "enabled" && statusResult
+      ? traeGlobalHooksActivationRequired(statusResult)
+      : false,
   };
 }
 
@@ -1198,6 +1265,8 @@ function printReconcileFailure(result, {
   opencodeSkipReason,
   skipCodeBuddyAdapter,
   codebuddySkipReason,
+  skipTraeAdapter,
+  traeSkipReason,
 }) {
   if (result.reason === "hook-runtime-activation-failed") {
     logRed("Client Hook runtime activation failed; automatic lifecycle recovery was skipped.");
@@ -1216,6 +1285,7 @@ function printReconcileFailure(result, {
       claudeSkipReason,
       opencodeSkipReason,
       codebuddySkipReason,
+      traeSkipReason,
     });
   }
 }
@@ -1230,6 +1300,11 @@ function dshAdapterUnavailable(statusResult) {
   return /\bDSH adapter:\s*unavailable\b/im.test(stripAnsi(output));
 }
 
+function traeGlobalHooksActivationRequired(statusResult) {
+  const output = `${statusResult.stdout ?? ""}\n${statusResult.stderr ?? ""}`;
+  return /\bTrae adapter:\s*ok\b[^\r\n]*\bhook-runtime=unverified\b/im.test(stripAnsi(output));
+}
+
 function pendingClientHookRuntimeEnv() {
   return {
     MEMORAX_CODE_PENDING_CLIENT_HOOK_RUNTIME_V1: JSON.stringify({
@@ -1252,10 +1327,10 @@ function clientLifecycleFlags({ clientMode = "all" } = {}) {
 }
 
 function clientModeFor(clients, { includeDsh = false } = {}) {
-  const selected = ["codex", "claude", "dsh", "opencode", "codebuddy"].filter((client) => (
+  const selected = ["codex", "claude", "dsh", "opencode", "codebuddy", "trae"].filter((client) => (
     client === "dsh" ? includeDsh : clients.includes(client)
   ));
-  if (selected.length === 5) return "all";
+  if (selected.length === 6) return "all";
   return selected.length > 0 ? selected.join(",") : "none";
 }
 
@@ -1273,6 +1348,7 @@ function clientSelectionMessage(clients, { dshSelected = false } = {}) {
       "DeepSeek Harness",
       clients.includes("opencode") ? "OpenCode" : undefined,
       clients.includes("codebuddy") ? "CodeBuddy/WorkBuddy" : undefined,
+      clients.includes("trae") ? "Trae" : undefined,
     ].filter(Boolean);
     return `Configuring MemoraX Code for ${joinedLabels(labels)}.`;
   }
@@ -1280,11 +1356,13 @@ function clientSelectionMessage(clients, { dshSelected = false } = {}) {
   const hasClaude = clients.includes("claude");
   const hasOpenCode = clients.includes("opencode");
   const hasCodeBuddy = clients.includes("codebuddy");
+  const hasTrae = clients.includes("trae");
   const labels = [
     hasCodex ? "Codex" : undefined,
     hasClaude ? "Claude Code" : undefined,
     hasOpenCode ? "OpenCode" : undefined,
     hasCodeBuddy ? "CodeBuddy/WorkBuddy" : undefined,
+    hasTrae ? "Trae" : undefined,
   ].filter(Boolean);
   if (labels.length > 0) return `Configuring MemoraX Code for ${joinedLabels(labels)}.`;
   return "Skipping client adapter setup for this setup.";
@@ -1294,7 +1372,8 @@ function clientLabel(client) {
   if (client === "codex") return "Codex";
   if (client === "claude") return "Claude Code";
   if (client === "opencode") return "OpenCode";
-  return "CodeBuddy/WorkBuddy";
+  if (client === "codebuddy") return "CodeBuddy/WorkBuddy";
+  return "Trae";
 }
 
 function detectedClientMessage(clients, dshProfiles = []) {
@@ -1453,12 +1532,15 @@ function printNextSteps({
   dshAdapterEnabled = false,
   opencodeAdapterEnabled = true,
   codebuddyAdapterEnabled = true,
+  traeAdapterEnabled = true,
+  traeGlobalHooksActivationRequired = false,
 } = {}) {
   const clientText = enabledClientText({
     codexAdapterEnabled,
     claudeAdapterEnabled,
     opencodeAdapterEnabled,
     codebuddyAdapterEnabled,
+    traeAdapterEnabled,
   });
   if (clientText && existingSetup) {
     logGreen(`${bold("The new Hook runtime is active")}; existing sessions with the stable shell select it on their next user prompt.`);
@@ -1474,11 +1556,15 @@ function printNextSteps({
   if (codexAdapterEnabled && !existingSetup) {
     logGreen(`After restart, ${bold("enable the MemoraX Code Codex Adapter plugin")} from Codex Plugins or CLI \`/plugins\` if it is not already enabled.`);
   }
+  if (traeAdapterEnabled && traeGlobalHooksActivationRequired) {
+    logGreen(`${bold("Open Trae Settings and enable Global Hooks once")}, then start a new Trae session.`);
+  }
   const statusCommands = statusCommandText({
     codexAdapterEnabled,
     claudeAdapterEnabled,
     opencodeAdapterEnabled,
     codebuddyAdapterEnabled,
+    traeAdapterEnabled,
   });
   if (clientText || !dshAdapterEnabled) {
     log(`If MemoraX Code is not active ${existingSetup ? "on the next prompt" : "in new sessions"}, run ${statusCommands}.`);
@@ -1493,12 +1579,14 @@ function enabledClientText({
   claudeAdapterEnabled = true,
   opencodeAdapterEnabled = true,
   codebuddyAdapterEnabled = true,
+  traeAdapterEnabled = true,
 } = {}) {
   const labels = [
     codexAdapterEnabled ? "Codex" : undefined,
     claudeAdapterEnabled ? "Claude Code" : undefined,
     opencodeAdapterEnabled ? "OpenCode" : undefined,
     codebuddyAdapterEnabled ? "CodeBuddy/WorkBuddy" : undefined,
+    traeAdapterEnabled ? "Trae" : undefined,
   ].filter(Boolean);
   if (labels.length < 2) return labels[0] ?? "";
   if (labels.length === 2) return `${labels[0]} or ${labels[1]}`;
@@ -1510,12 +1598,14 @@ function statusCommandText({
   claudeAdapterEnabled = true,
   opencodeAdapterEnabled = true,
   codebuddyAdapterEnabled = true,
+  traeAdapterEnabled = true,
 } = {}) {
   const commands = ["`memorax-code status`"];
   if (codexAdapterEnabled) commands.push("`memorax-code-codex status`");
   if (claudeAdapterEnabled) commands.push("`memorax-code-claude status`");
   if (opencodeAdapterEnabled) commands.push("`memorax-code-opencode status`");
   if (codebuddyAdapterEnabled) commands.push("`memorax-code-codebuddy status`");
+  if (traeAdapterEnabled) commands.push("`memorax-code-trae status`");
   if (commands.length === 1) return commands[0];
   if (commands.length === 2) return `${commands[0]} and ${commands[1]}`;
   return `${commands.slice(0, -1).join(", ")}, and ${commands.at(-1)}`;
@@ -1595,19 +1685,21 @@ function readMemoraxInstallStatus() {
   }
 }
 
-function printUnavailableDiagnostics({ codexSkipReason, claudeSkipReason, opencodeSkipReason, codebuddySkipReason } = {}) {
+function printUnavailableDiagnostics({ codexSkipReason, claudeSkipReason, opencodeSkipReason, codebuddySkipReason, traeSkipReason } = {}) {
   logRed("MemoraX Code is not enabled for new client sessions.");
-  logRed("Check `memorax-code status`, the selected adapter status commands, and `memorax-code-codebuddy status` for Backend and integration details.");
-  logRed("If Codex, Claude Code, OpenCode, CodeBuddy/WorkBuddy, or DeepSeek Harness is open, restart or refresh it after fixing the reported status.");
+  logRed("Check `memorax-code status` and the selected adapter status commands for Backend and integration details.");
+  logRed("If Codex, Claude Code, OpenCode, CodeBuddy/WorkBuddy, Trae, or DeepSeek Harness is open, restart or refresh it after fixing the reported status.");
   if (codexSkipReason) printCodexSkippedDiagnostics(codexSkipReason);
   if (claudeSkipReason) printClaudeSkippedDiagnostics(claudeSkipReason);
   if (opencodeSkipReason) printOpenCodeSkippedDiagnostics(opencodeSkipReason);
   if (codebuddySkipReason) printCodeBuddySkippedDiagnostics(codebuddySkipReason);
+  if (traeSkipReason) printTraeSkippedDiagnostics(traeSkipReason);
   printCommonCommands({
     codexAdapterEnabled: !codexSkipReason,
     claudeAdapterEnabled: !claudeSkipReason,
     opencodeAdapterEnabled: !opencodeSkipReason,
     codebuddyAdapterEnabled: !codebuddySkipReason,
+    traeAdapterEnabled: !traeSkipReason,
   });
 }
 
@@ -1633,6 +1725,11 @@ function printCodeBuddySkippedDiagnostics() {
   log("Run `memorax-code start --clients codebuddy` after installing CodeBuddy/WorkBuddy, then restart or refresh it.");
 }
 
+function printTraeSkippedDiagnostics() {
+  logRed("Trae adapter setup was skipped for this setup, so MemoraX Code left Trae unchanged.");
+  log("Run `memorax-code start --clients trae` after installing Trae, then enable Global Hooks in Trae Settings and start a new session.");
+}
+
 function printFailureSuggestions() {
   logRed("Suggested recovery: run `memorax-code stop`, then `memorax-code start`, then `memorax-code status`.");
   logRed("If the Backend port is busy, stop the process using 127.0.0.1:8787 and retry `memorax-code start`.");
@@ -1663,6 +1760,7 @@ function printCommonCommands({
   claudeAdapterEnabled = true,
   opencodeAdapterEnabled = true,
   codebuddyAdapterEnabled = true,
+  traeAdapterEnabled = true,
 } = {}) {
   log("Common commands:");
   log("- `memorax-code status`: check the local backend and adapter state.");
@@ -1673,6 +1771,7 @@ function printCommonCommands({
   if (claudeAdapterEnabled) log("- `memorax-code-claude sessions`: verify recent native Claude Code session registration.");
   if (opencodeAdapterEnabled) log("- `memorax-code-opencode doctor`: verify the managed OpenCode plugin, runtime evidence, and Backend health.");
   if (codebuddyAdapterEnabled) log("- `memorax-code-codebuddy status`: verify the managed CodeBuddy/WorkBuddy plugin and Hook integration.");
+  if (traeAdapterEnabled) log("- `memorax-code-trae status`: verify the managed Trae Global Hooks and Skill integration.");
 }
 
 function memoraxCodeEnabled(statusResult, {
@@ -1680,6 +1779,7 @@ function memoraxCodeEnabled(statusResult, {
   claudeAdapterRequired = true,
   opencodeAdapterRequired = true,
   codebuddyAdapterRequired = true,
+  traeAdapterRequired = true,
 } = {}) {
   const output = `${statusResult.stdout ?? ""}\n${statusResult.stderr ?? ""}`;
   const normalized = stripAnsi(output);
@@ -1692,12 +1792,14 @@ function memoraxCodeEnabled(statusResult, {
   const claudeAdapterOk = /Claude adapter:\s*ok\b/im.test(normalized);
   const opencodeAdapterOk = /OpenCode adapter:\s*ok\b/im.test(normalized);
   const codebuddyAdapterOk = /CodeBuddy adapter:\s*ok\b/im.test(normalized);
+  const traeAdapterOk = /Trae adapter:\s*ok\b/im.test(normalized);
   return backendOk
     && serviceOk
     && (!codexAdapterRequired || codexAdapterOk)
     && (!claudeAdapterRequired || claudeAdapterOk)
     && (!opencodeAdapterRequired || opencodeAdapterOk)
-    && (!codebuddyAdapterRequired || codebuddyAdapterOk);
+    && (!codebuddyAdapterRequired || codebuddyAdapterOk)
+    && (!traeAdapterRequired || traeAdapterOk);
 }
 
 function log(message) {

package/bin/memorax-code-trae.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runTraeAdapterCli } from "../lib/run-entrypoint.mjs";
+
+await runTraeAdapterCli();