memorix 1.8.8 → 1.8.9

package/docs/AGENT_OPERATOR_PLAYBOOK.md

@@ -23,7 +23,7 @@ It supports:
 - HTTP MCP service + dashboard (`memorix background start` or `memorix serve-http --port 3211`)
 - bundled terminal agent (`memorix` or `memcode`) that uses the same shared memory pool
 - local-first project-scoped memory
-- cross-agent recall across Cursor, Claude Code, Codex, CodeBuddy Code, Windsurf, Gemini CLI, GitHub Copilot, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, and DeepSeek Harness
+- cross-agent recall across Cursor, Claude Code, Codex, CodeBuddy Code, Windsurf, Gemini CLI, GitHub Copilot, OpenCode, Grok Build, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and WorkBuddy
 
 ### Current 1.4 Baseline
 
@@ -41,7 +41,7 @@ For the 1.4 release line, the visible product shape is:
 - `memorix_project_context` / `memorix context "..."` is the normal black-box entry for non-trivial coding work: it assembles a bounded task Workset instead of injecting a generic memory dump; `memorix resume "..."` is the explicit CLI continuation projection
 - Code State keeps local snapshots and freshness links; a healthy pre-existing local CodeGraph index can add a bounded semantic outline, but Memorix never initializes or synchronizes that external index itself
 - `memorix knowledge` is an explicit review path for source-backed Markdown knowledge and canonical workflows. Do not initialize a versioned workspace or apply a proposal unless the user asks for that managed artifact
-- integration surfaces are agent-specific: Claude Code, Codex, GitHub Copilot CLI, Antigravity, and Hermes receive plugin packages; OpenClaw receives a compatible bundle; Pi and Oh-my-Pi receive package entries; Gemini CLI receives an extension package; OpenCode receives a plugin file and skill; DeepSeek Harness receives an MCP patch row, AGENTS.md guidance, and skills; Cursor and other agents receive MCP/rules/hooks where supported
+- integration surfaces are agent-specific: Claude Code, Codex, GitHub Copilot CLI, Antigravity, and Hermes receive plugin packages; OpenClaw receives a compatible bundle; Pi and Oh-my-Pi receive package entries; Gemini CLI receives an extension package; OpenCode receives a plugin file and skill; Grok Build receives native hooks and `AGENTS.md` guidance while keeping MCP host-owned; DeepSeek Harness receives an MCP patch row, AGENTS.md guidance, and skills; Cursor and other agents receive MCP/rules/hooks where supported
 - privacy-safe diagnostics and receipts avoid raw chat, memory text, query text, tool payloads, and local file paths
 
 ---
@@ -245,6 +245,7 @@ memorix setup --agent opencode --global
 memorix setup --agent openclaw --global
 memorix setup --agent hermes --global
 memorix setup --agent omp --global
+memorix setup --agent grok --global
 ```
 
 What this installs depends on the target agent:
@@ -256,6 +257,7 @@ What this installs depends on the target agent:
 - Pi: user Pi package with extension-based hook capture and a Memorix skill, registered through `pi install <path> --approve`; project-local setup uses `-l`.
 - Gemini CLI: local extension package under `~/.gemini/extensions/memorix`, extension-bundled stdio MCP, `GEMINI.md` context, hooks, commands, and skills. Antigravity CLI has an official Gemini CLI migration path, but Gemini CLI remains a separate target.
 - OpenCode: local plugin file, `opencode.json` MCP config, OpenCode skill, plus `AGENTS.md` guidance.
+- Grok Build: native hooks in `~/.grok/hooks/memorix.json` and guidance in `~/.grok/AGENTS.md`. Global hooks are trusted; project hooks require Grok `/hooks-trust` or `--trust`. Memorix does not write Grok's `config.toml` or MCP entries.
 - Antigravity: native plugin under `~/.gemini/config/plugins/memorix` or `.agents/plugins/memorix`, with `plugin.json`, `mcp_config.json`, `hooks.json`, rules, and skills.
 - OpenClaw: OpenClaw-compatible bundle under `~/.openclaw/extensions/memorix`, bundled `.mcp.json`, skills, and OpenClaw `HOOK.md`/`handler.ts` hook pack.
 - Hermes Agent: Hermes plugin under Hermes home (`%LOCALAPPDATA%\hermes` on native Windows, `~/.hermes` elsewhere, or `HERMES_HOME`), enabled in `config.yaml`, with plugin hooks, slash command, CLI command, skills, and MCP config.

package/docs/INTEGRATIONS.md

@@ -53,6 +53,7 @@ Generated guidance also has scope:
 | CodeBuddy Code | `memorix setup --agent codebuddy --global` | CodeBuddy local marketplace plugin | `~/.codebuddy/memorix-local` marketplace with `.codebuddy-plugin`, bundled stdio MCP, skills, and hooks | Setup attempts `codebuddy plugin marketplace add` then user-scope install. It does not alter existing CodeBuddy settings, permissions, or model configuration; review third-party hooks in CodeBuddy's `/hooks` flow before enabling them. |
 | GitHub Copilot CLI | `memorix setup --agent copilot --global` | Copilot CLI plugin package | Local plugin under `~/.copilot/plugins/local/memorix` with MCP, skills, and hooks | Setup attempts `copilot plugin install <local-path>` when Copilot CLI is available. |
 | Cursor | `memorix setup --agent cursor --global` | Cursor MCP and rules config | Cursor MCP config, `.cursor/rules/memorix.mdc`, skills, and hook guidance | Reload Cursor after setup so it can pick up project config changes. |
+| Grok Build | `memorix setup --agent grok --global` | `~/.grok/hooks/memorix.json` + `~/.grok/AGENTS.md` | Lifecycle hooks on SessionStart, SessionEnd, UserPromptSubmit, PostToolUse, PostToolUseFailure, PreCompact, PostCompact, Stop, and StopFailure, plus Grok project/global guidance | Uses Grok's own JSON hook directory and never writes `~/.grok/config.toml` or MCP entries. Global hooks are trusted; project hooks require Grok `/hooks-trust`. Set `GROK_HOME` to use a custom Grok home. The command is `memorix hook --agent grok`. |
 | Gemini CLI | `memorix setup --agent gemini-cli --global` | Gemini CLI extension | Extension under `~/.gemini/extensions/memorix` with MCP, `GEMINI.md` context, hooks, commands, and skills | Antigravity CLI has an official Gemini CLI migration path, but Gemini CLI remains an active standalone Google CLI target. |
 | OpenCode | `memorix setup --agent opencode --global` | OpenCode local plugin file | Global setup writes `~/.config/opencode/plugins/memorix.js`, `~/.config/opencode/opencode.json`, skills, and `AGENTS.md` guidance; repo-local setup writes the `.opencode/` equivalents. | OpenCode loads local plugin and skill files from its config scope. |
 | OpenClaw | `memorix setup --agent openclaw --global` | OpenClaw compatible bundle | `~/.openclaw/extensions/memorix` with `.mcp.json`, skills, and OpenClaw `HOOK.md`/`handler.ts` hook pack | Setup attempts `openclaw plugins install <path> --force` and `openclaw hooks enable memorix` when OpenClaw is available. |

package/docs/hooks-architecture.md

@@ -9,17 +9,18 @@
 
 ### 事件映射表
 
-| 语义 | VS Code Copilot | Claude Code | Codex | Windsurf | Cursor (Beta) | Kiro |
-|------|----------------|-------------|-------|----------|---------------|------|
-| 会话开始 | SessionStart | SessionStart | SessionStart | — | — | — |
-| 用户输入 | UserPromptSubmit | UserPromptSubmit | UserPromptSubmit | pre_user_prompt | beforeSubmitPrompt | user prompt |
-| 工具调用前 | PreToolUse | PreToolUse | — | pre_mcp_tool_use | beforeMCPExecution | — |
-| 工具调用后 | PostToolUse | PostToolUse | PostToolUse | post_mcp_tool_use | — | — |
-| 文件编辑后 | PostToolUse(write) | PostToolUse(write) | PostToolUse(apply_patch) | post_write_code | afterFileEdit | file save |
-| 命令执行后 | PostToolUse(cmd) | PostToolUse(cmd) | PostToolUse(Bash) | post_run_command | — | — |
-| AI 回复后 | — | — | Stop | post_cascade_response | — | agent turn |
-| 上下文压缩前 | PreCompact | PreCompact | PreCompact | — | — | — |
-| 会话结束 | Stop | Stop | Stop | — | stop | — |
+| 语义 | VS Code Copilot | Claude Code | Codex | Windsurf | Cursor (Beta) | Kiro | Grok Build |
+|------|----------------|-------------|-------|----------|---------------|------|------------|
+| 会话开始 | SessionStart | SessionStart | SessionStart | — | — | — | SessionStart |
+| 用户输入 | UserPromptSubmit | UserPromptSubmit | UserPromptSubmit | pre_user_prompt | beforeSubmitPrompt | user prompt | UserPromptSubmit |
+| 工具调用前 | PreToolUse | PreToolUse | — | pre_mcp_tool_use | beforeMCPExecution | — | PreToolUse（仅观察） |
+| 工具调用后 | PostToolUse | PostToolUse | PostToolUse | post_mcp_tool_use | — | — | PostToolUse / PostToolUseFailure |
+| 文件编辑后 | PostToolUse(write) | PostToolUse(write) | PostToolUse(apply_patch) | post_write_code | afterFileEdit | file save | PostToolUse(search_replace) |
+| 命令执行后 | PostToolUse(cmd) | PostToolUse(cmd) | PostToolUse(Bash) | post_run_command | — | — | PostToolUse(run_terminal_command) |
+| AI 回复后 | — | — | Stop | post_cascade_response | — | agent turn | Stop / StopFailure |
+| 上下文压缩前 | PreCompact | PreCompact | PreCompact | — | — | — | PreCompact |
+| 上下文压缩后 | — | — | — | — | — | — | PostCompact |
+| 会话结束 | Stop | Stop | Stop | — | stop | — | SessionEnd |
 
 ### 配置文件位置
 
@@ -29,7 +30,8 @@
 | Claude Code | `.claude/settings.json` | 原生 |
 | Codex | 用户级 Memorix 插件内 `hooks/hooks.json` | Codex plugin hooks；通过 `memorix setup --agent codex --global` 安装，不写项目 `.codex/hooks.json` |
 | Windsurf | `.windsurf/cascade.json` | Windsurf 格式 |
-| Cursor | `.cursor/hooks.json` | Cursor 格式 |
+| Cursor | `.cursor/hooks.json` |
+| Grok Build | `~/.grok/hooks/memorix.json` | Cursor 格式 |
 | Kiro | `.kiro/hooks/*.hook.md` | Markdown + YAML |
 
 ### stdin/stdout 通信协议
@@ -48,6 +50,9 @@
 
 // Cursor
 { "hook_event_name": "afterFileEdit", "conversation_id": "...", "generation_id": "...", ... }
+
+// Grok Build
+{ "hookEventName": "PostToolUse", "sessionId": "...", "cwd": "...", "workspaceRoot": "...", "toolName": "search_replace", "toolInput": { "path": "..." }, "toolResult": { ... } }
 ```
 
 ## Memorix Hook Handler 设计
@@ -85,7 +90,7 @@ memorix hook <normalized_event> [--agent <agent_name>]
 ```bash
 memorix hooks install
 # 自动检测已安装的 Agent → 生成对应配置文件
-# 支持: --agent claude|codex|cursor|windsurf|copilot|opencode|kiro|antigravity|gemini-cli|trae
+# 支持: --agent claude|codex|cursor|windsurf|copilot|opencode|kiro|antigravity|gemini-cli|trae|grok
 # openclaw/hermes/omp/codex 的 hooks 随插件包安装，使用 `memorix setup --agent <agent>`
 # 支持: --project (仅当前项目) | --global (全局)
 ```

package/llms-full.txt

@@ -2,7 +2,7 @@
 
 > Local-first shared memory layer for AI coding agents.
 
-Memorix is a TypeScript/Node.js project that gives AI coding agents persistent, project-aware memory. It targets software development workflows, not generic chat. It works across Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and any agent that can speak MCP over stdio or HTTP. Integrations usually start with `memorix setup --agent <agent> --global`, which installs the recommended user-level package or config for that agent: plugin packages when supported, package or extension entries, MCP config, generated guidance, hooks, skills, or the bundled terminal agent.
+Memorix is a TypeScript/Node.js project that gives AI coding agents persistent, project-aware memory. It targets software development workflows, not generic chat. It works across Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, Grok Build, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, WorkBuddy, and any agent that can speak MCP over stdio or HTTP. Integrations usually start with `memorix setup --agent <agent> --global`, which installs the recommended user-level package or config for that agent: plugin packages when supported, package or extension entries, MCP config, generated guidance, hooks, skills, or the bundled terminal agent.
 
 If you are an AI coding agent helping a user install, operate, or troubleshoot Memorix, read `docs/AGENT_OPERATOR_PLAYBOOK.md` before taking action. It is the main reference for install, runtime selection, Git/project binding, MCP integration, hooks, and troubleshooting.
 
@@ -35,6 +35,7 @@ It installs the recommended Memorix integration for the target agent:
 - Pi: user Pi package with a Memorix extension and skill. Setup also attempts `pi install <path> --approve`; project-local setup uses `-l`.
 - Gemini CLI: local Gemini extension package with MCP and `GEMINI.md` context.
 - OpenCode: local plugin file, `opencode.json` MCP config, OpenCode skill, and `AGENTS.md` guidance.
+- Grok Build: native lifecycle hooks in `~/.grok/hooks/memorix.json` and `~/.grok/AGENTS.md` guidance. Grok owns its MCP configuration; project hooks require `/hooks-trust`.
 - Windsurf, Kiro, Antigravity, Trae: MCP config plus rules/hooks where supported.
 - DeepSeek Harness: MCP patch row (`$DSH_HOME/cordis.patch.yml`) plus `AGENTS.md` guidance and official skills.
 
@@ -50,6 +51,7 @@ memorix setup --agent cursor --global
 memorix setup --agent pi --global
 memorix setup --agent gemini-cli --global
 memorix setup --agent opencode --global
+memorix setup --agent grok --global
 ```
 
 Manual `memorix integrate --agent <agent>` and `memorix hooks install --agent <agent>` are fallback commands for updating one generated integration without running the full setup package. Run setup without `--global` only when you intentionally want repo-local guidance, rules, or hooks for one project.

package/llms.txt

@@ -2,7 +2,7 @@
 
 > Local-first shared memory layer for AI coding agents.
 
-Memorix gives coding agents persistent, project-aware memory across sessions, IDEs, terminals, and MCP clients. It stores project knowledge once so multiple agents can retrieve it through plugin packages, MCP, CLI, SDK, generated rules/instructions, hooks, skills, local plugins, or the bundled terminal agent. It works with Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and other MCP-capable agents.
+Memorix gives coding agents persistent, project-aware memory across sessions, IDEs, terminals, and MCP clients. It stores project knowledge once so multiple agents can retrieve it through plugin packages, MCP, CLI, SDK, generated rules/instructions, hooks, skills, local plugins, or the bundled terminal agent. It works with Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, Grok Build, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, WorkBuddy, and other MCP-capable agents.
 
 ## Entry Points
 
@@ -14,6 +14,7 @@ Memorix gives coding agents persistent, project-aware memory across sessions, ID
 - `memorix integrate --agent <agent>` and `memorix hooks install --agent <agent>` are manual/fallback generation commands.
 - `memorix` and `memcode` open memcode, the bundled terminal agent that uses the same project memory pool.
 - `memorix dashboard` opens the local read-mostly dashboard.
+- `memorix setup --agent grok --global` installs Grok's native lifecycle hooks and `AGENTS.md` guidance; Grok keeps MCP configuration under its own control.
 
 ## Memory Model
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -105,6 +105,7 @@
     "cross-agent-memory",
     "context-persistence",
     "agent-memory",
+    "grok-build",
     "memcode",
     "coding-agent",
     "terminal-agent",

package/plugins/antigravity/memorix/plugin.json

@@ -1,4 +1,4 @@
 {
   "name": "memorix",
-  "version": "1.8.8"
+  "version": "1.8.9"
 }

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/hermes/memorix/plugin.yaml

@@ -1,5 +1,5 @@
 name: memorix
-version: "1.8.8"
+version: "1.8.9"
 description: Shared workspace memory bridge for Hermes Agent.
 author: AVIDS2
 license: Apache-2.0

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.8.8",
+  "version": "1.8.9",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.8.8",
+  "version": "1.8.9",
   "websiteUrl": "https://mem.rglens.com",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.8.8",
+      "version": "1.8.9",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/cli/commands/agent-integrations.ts

@@ -126,6 +126,7 @@ const GUIDANCE_AGENTS = new Set<AgentName>([
   'trae',
   'dsh',
   'workbuddy',
+  'grok',
 ]);
 
 const CODEX_PLUGIN_NAME = 'memorix';
@@ -167,7 +168,7 @@ function worstStatus(statuses: AgentIntegrationStatus[]): AgentIntegrationStatus
 }
 
 function isMcpConfigAgent(agent: AgentName): agent is McpConfigAgent {
-  return agent !== 'pi';
+  return agent !== 'pi' && agent !== 'grok';
 }
 
 function isActionableMcpRepairIssue(issue: string): boolean {

package/src/cli/commands/hooks-install.ts

@@ -166,6 +166,7 @@ function getAgentLabel(agent: string): string {
     trae: 'Trae',
     dsh: 'DeepSeek Harness',
     workbuddy: 'WorkBuddy',
+    grok: 'Grok Build',
   };
   return labels[agent] || agent;
 }
@@ -186,6 +187,7 @@ function getAgentHint(agent: string): string {
     trae: '.trae/rules/project_rules.md (rules only, no hooks system)',
     dsh: '~/.dsh/cordis.patch.yml MCP row via `memorix setup --agent dsh` (no hooks system)',
     workbuddy: '~/.workbuddy/mcp.json MCP row via `memorix setup --agent workbuddy` (no hooks system)',
+    grok: '~/.grok/hooks/memorix.json (own file, not RuleSync dest)',
     codex: 'Codex plugin hooks; use `memorix setup --agent codex`',
   };
   return hints[agent] || '';

package/src/cli/commands/integrate.ts

@@ -116,6 +116,7 @@ function getAgentLabel(agent: string): string {
     trae: 'Trae',
     dsh: 'DeepSeek Harness',
     workbuddy: 'WorkBuddy',
+    grok: 'Grok Build',
   };
   return labels[agent] || agent;
 }
@@ -134,6 +135,7 @@ function getAgentHint(agent: string): string {
     trae: 'rules',
     dsh: 'MCP patch + AGENTS.md + skills',
     workbuddy: 'MCP + AGENTS.md',
+    grok: 'hooks file (~/.grok/hooks/memorix.json)',
   };
   return hints[agent] || 'integration files';
 }

package/src/cli/commands/setup.ts

@@ -195,6 +195,7 @@ const SUPPORTED_SETUP_AGENTS: AgentName[] = [
   'dsh',
   'workbuddy',
   'pi',
+  'grok',
 ];
 
 export function getSetupAgentTargets(): AgentName[] {
@@ -211,7 +212,9 @@ export function buildSetupPlan(options: {
   plugin?: boolean;
   global?: boolean;
 }): SetupPlan {
-  const mcp = options.mcp ?? 'stdio';
+  // Grok owns its MCP configuration through `grok mcp`; Memorix setup only
+  // installs the independent hooks/rules integration for this target.
+  const mcp = options.agent === 'grok' ? 'none' : options.mcp ?? 'stdio';
   const actions: SetupAction[] = [];
   const isPackageOwnedAgent = options.agent !== 'all' && PACKAGE_OWNED_INTEGRATION_AGENTS.has(options.agent);
   const includeHooks = options.hooks ?? true;
@@ -388,7 +391,7 @@ function relativePosix(from: string, to: string): string {
   return rel;
 }
 
-export type McpConfigAgent = Exclude<AgentName, 'pi'>;
+export type McpConfigAgent = Exclude<AgentName, 'pi' | 'grok'>;
 
 export function getMcpAdapter(agent: McpConfigAgent): MCPConfigAdapter {
   const adapters: Record<McpConfigAgent, MCPConfigAdapter> = {
@@ -1453,7 +1456,7 @@ export async function installAgentSetup(agent: AgentName, plan: SetupPlan, globa
   const hasCodeBuddyPlugin = plan.actions.includes('codebuddy-plugin') && agent === 'codebuddy';
   // Codex's supported default is the user-level plugin. Never create a
   // project-local .codex/config.toml as an implicit fallback.
-  const wantsMcpConfig = plan.mcp !== 'none' && agent !== 'pi' && !(agent === 'codex' && !global);
+  const wantsMcpConfig = plan.mcp !== 'none' && agent !== 'pi' && agent !== 'grok' && !(agent === 'codex' && !global);
 
   if (PLUGIN_PACKAGE_AGENTS.has(agent) && plan.includePlugin && !global) {
     p.log.info(`${agent}: project setup leaves user-level plugins untouched. Run \`memorix setup --agent ${agent} --global\` to install its plugin, skills, and lifecycle hooks.`);
@@ -1633,6 +1636,9 @@ export async function installAgentSetup(agent: AgentName, plan: SetupPlan, globa
 
   if (agent === 'pi') {
     p.log.info('pi: Pi has no MCP config lane in the current CLI; use the installed package extension and skill.');
+  } else if (agent === 'grok') {
+    p.log.info('grok: lifecycle hooks write ~/.grok/hooks/memorix.json. MCP stays host-owned (do not write config.toml).');
+    if (!global) p.log.info('grok: project hooks require `/hooks-trust` or launching Grok with `--trust`.');
   } else if (plan.mcp === 'stdio') {
     p.log.info(`${agent}: MCP server command is \`memorix serve\``);
   } else if (plan.mcp === 'http') {
@@ -1669,7 +1675,7 @@ export default defineCommand({
   args: {
     agent: {
       type: 'string',
-      description: 'Target agent (claude, codex, codebuddy, opencode, cursor, windsurf, copilot, gemini-cli, antigravity, openclaw, hermes, omp, kiro, trae, dsh, pi, all)',
+      description: 'Target agent (claude, codex, codebuddy, opencode, cursor, windsurf, copilot, gemini-cli, antigravity, openclaw, hermes, omp, kiro, trae, dsh, pi, grok, all)',
       required: false,
     },
     mcp: {
@@ -1738,6 +1744,7 @@ export default defineCommand({
           { value: 'codex', label: 'Codex', hint: 'plugin package + marketplace + MCP' },
           { value: 'copilot', label: 'GitHub Copilot CLI', hint: 'plugin package + hooks + MCP' },
           { value: 'cursor', label: 'Cursor', hint: 'MCP + rules + skills' },
+          { value: 'grok', label: 'Grok Build', hint: 'hooks file; MCP stays host-owned' },
           { value: 'gemini-cli', label: 'Gemini CLI', hint: 'extension + MCP' },
           { value: 'openclaw', label: 'OpenClaw', hint: 'bundle + hook pack + skills + MCP' },
           { value: 'hermes', label: 'Hermes Agent', hint: 'plugin + hooks + commands + skills + MCP' },

package/src/hooks/handler.ts

@@ -737,6 +737,12 @@ export function formatHookOutput(
     };
   }
 
+  // Grok's documented hook contract only gives passive hooks a success exit
+  // signal; it does not define a Claude-style additionalContext response.
+  // Returning an empty object keeps Memorix capture-only and never changes
+  // Grok's prompt, tool, or stop decisions.
+  if (agent === 'grok') return {};
+
   const finalOutput: Record<string, unknown> = { ...output };
   const hookSpecificOutputEvents = new Set([
     'PreToolUse',