@xmemo/client 0.4.163 → 0.4.164

package/README.md

@@ -43,6 +43,8 @@ xmemo setup antigravity
 xmemo setup antigravity --dry-run
 xmemo setup kiro
 xmemo setup kiro --dry-run
+xmemo setup grok
+xmemo setup grok --dry-run
 xmemo mcp add antigravity2
 xmemo mcp add antigravity2 --write
 xmemo doctor
@@ -447,6 +449,38 @@ After setup, restart Kiro or reload MCP servers for the changes to take effect.
 The CLI refuses to overwrite an existing `XMemo`, `memory_os`, or `memory-os`
 MCP server entry. Edit the config manually if you need to rotate the endpoint.
 
+### Grok (xAI)
+
+Recommended Grok setup:
+
+```bash
+xmemo setup grok
+```
+
+`setup grok` appends an XMemo MCP server to Grok's user config at
+`~/.grok/config.toml` using Grok's TOML `[mcp_servers.XMemo]` format with `url`,
+`bearer_token_env_var = "XMEMO_KEY"`, and an `[mcp_servers.XMemo.http_headers]`
+table carrying `X-Memory-OS-Agent-ID`. Use `xmemo setup grok --dry-run` to
+preview without writing.
+
+Set your XMemo token with:
+
+```bash
+xmemo login
+# or
+printf '%s\n' 'your-token' | xmemo token add --from-stdin
+```
+
+Grok is also fully compatible with Claude Code: it automatically reads Claude
+Code marketplaces, plugins, skills, and MCP servers. So `xmemo setup claude-code`
+plus the repo's `.claude-plugin/`, `.mcp.json`, and `skills/` are discovered by
+Grok with zero extra configuration. Use `xmemo setup grok` when you want the
+server written directly into Grok's own `~/.grok/config.toml`.
+
+After setup, restart Grok or run `/mcps` to reload MCP servers. The CLI refuses
+to overwrite an existing `XMemo` MCP server entry; edit the config manually if
+you need to rotate the endpoint.
+
 ### Antigravity 2.0
 
 Recommended Antigravity 2.0 setup:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmemo/client",
-  "version": "0.4.163",
+  "version": "0.4.164",
   "description": "Privacy-first CLI and MCP setup helper for XMemo.",
   "mcpName": "io.github.yonro/xmemo",
   "type": "module",

package/plugins/kiro/steering/AGENTS.md

@@ -13,10 +13,10 @@ Use XMemo when the task may depend on prior memory, durable project context, cod
 ## Workflow
 
 1. **Recall first** when prior context could change the answer. Use XMemo search/recall/context tools before making assumptions about preferences or past decisions.
-2. **Save only durable information** that the user asks to remember or that is clearly useful across future Kiro sessions.
+2. **Save only durable information** that the user asks to remember or that is clearly useful across future sessions.
 3. **Keep memory content concise, scoped, and useful**. Prefer concrete facts, decisions, links to public docs, and action items over chat transcripts.
 4. **For destructive memory actions**, confirm the exact target before deleting, forgetting, or overwriting.
-5. **If authorization errors occur**, ask the user to verify the `XMEMO_KEY` environment variable is set and to restart Kiro.
+5. **If authorization errors occur**, tell the user: "Run `xmemo login` or visit https://xmemo.dev to get your token, then set the `XMEMO_KEY` environment variable and restart Kiro."
 
 ## Good Memory Candidates
 

package/src/config/paths.js

@@ -12,6 +12,7 @@ export {
   defaultCopilotConfigPath,
   defaultCursorConfigPath,
   defaultGeminiConfigPath,
+  defaultGrokConfigPath,
   defaultHermesConfigPath,
   defaultJetbrainsConfigPath,
   defaultKiroConfigPath,

package/src/mcp/clients/registry.js

@@ -11,6 +11,14 @@ export function createMcpClients(deps) {
     configKind: 'toml'
   });
 
+  clients.set('grok', {
+    label: 'Grok',
+    defaultConfigPath: deps.defaultGrokConfigPath,
+    buildSnippet: deps.grokTomlSnippet,
+    writeConfig: deps.appendGrokServerConfig,
+    configKind: 'toml'
+  });
+
   for (const definition of deps.JSON_MCP_CLIENT_DEFINITIONS) {
     if (definition.id === 'qwen') {
       clients.set('hermes', hermesClient(deps));

package/src/mcp/clients.js

@@ -1,6 +1,8 @@
 import {
   appendTomlServerConfig,
-  codexTomlSnippet
+  appendGrokServerConfig,
+  codexTomlSnippet,
+  grokTomlSnippet
 } from './formats/toml.js';
 import {
   hermesYamlSnippet,
@@ -23,6 +25,7 @@ import {
   defaultContinueConfigPath,
   defaultCursorConfigPath,
   defaultGeminiConfigPath,
+  defaultGrokConfigPath,
   defaultHermesConfigPath,
   defaultJetbrainsConfigPath,
   defaultKiroConfigPath,
@@ -45,6 +48,9 @@ export const MCP_CLIENTS = createMcpClients({
   defaultCodexConfigPath,
   codexTomlSnippet,
   appendTomlServerConfig,
+  defaultGrokConfigPath,
+  grokTomlSnippet,
+  appendGrokServerConfig,
   defaultHermesConfigPath,
   hermesYamlSnippet,
   mergeHermesMcpConfig,

package/src/mcp/formats/toml.js

@@ -3,6 +3,9 @@ import path from 'node:path';
 
 import {
   COMMAND_NAME,
+  AGENT_ID_HEADER,
+  AGENT_INSTANCE_ENV_VAR,
+  AGENT_INSTANCE_HEADER,
   LEGACY_MCP_SERVER_NAMES,
   MCP_SERVER_NAME,
   TOKEN_ENV_VAR
@@ -18,13 +21,46 @@ import {
 } from '../../core/runtime.js';
 import { agentInstanceIdentityPath } from '../identity/device.js';
 
-export function codexTomlSnippet(mcpUrl) {
+export function codexTomlSnippet(mcpUrl, identity) {
+  const agentId = identity?.agentId ?? 'codex';
+  const agentInstanceId = identity?.agentInstanceId ?? `\${${AGENT_INSTANCE_ENV_VAR}}`;
   return `[mcp_servers.${MCP_SERVER_NAME}]
 url = "${escapeTomlString(mcpUrl)}"
 bearer_token_env_var = "${TOKEN_ENV_VAR}"
+
+[mcp_servers.${MCP_SERVER_NAME}.http_headers]
+${AGENT_ID_HEADER} = "${escapeTomlString(agentId)}"
+${AGENT_INSTANCE_HEADER} = "${escapeTomlString(agentInstanceId)}"
+`;
+}
+
+export function grokTomlSnippet(mcpUrl, identity) {
+  const agentId = identity?.agentId ?? 'grok';
+  const agentInstanceId = identity?.agentInstanceId ?? `\${${AGENT_INSTANCE_ENV_VAR}}`;
+  return `[mcp_servers.${MCP_SERVER_NAME}]
+url = "${escapeTomlString(mcpUrl)}"
+bearer_token_env_var = "${TOKEN_ENV_VAR}"
+
+[mcp_servers.${MCP_SERVER_NAME}.http_headers]
+${AGENT_ID_HEADER} = "${escapeTomlString(agentId)}"
+${AGENT_INSTANCE_HEADER} = "${escapeTomlString(agentInstanceId)}"
 `;
 }
 
+export async function appendGrokServerConfig(configPath, mcpUrl, identity) {
+  const snippet = grokTomlSnippet(mcpUrl, identity);
+  const existing = await readTextIfExists(configPath);
+  const existingName = existingTomlMcpServerName(existing);
+  if (existingName) {
+    throw new UsageError(`MCP config already contains [mcp_servers.${existingName}]. Edit ${configPath} manually to avoid duplicate server definitions.`);
+  }
+
+  await fs.mkdir(path.dirname(configPath), { recursive: true, mode: 0o700 });
+  const prefix = existing.trim().length === 0 ? '' : '\n\n';
+  await fs.appendFile(configPath, `${prefix}${snippet}`, { mode: 0o600 });
+  await bestEffortChmod(configPath, 0o600);
+}
+
 export async function codexSmokeReport(configPath, env) {
   const configText = await readTextIfExists(configPath);
   const serverBlock = findTomlServerBlock(configText);
@@ -91,8 +127,8 @@ export async function codexSmokeReport(configPath, env) {
   };
 }
 
-export async function appendTomlServerConfig(configPath, mcpUrl) {
-  const snippet = codexTomlSnippet(mcpUrl);
+export async function appendTomlServerConfig(configPath, mcpUrl, identity) {
+  const snippet = codexTomlSnippet(mcpUrl, identity);
   const existing = await readTextIfExists(configPath);
   const existingName = existingTomlMcpServerName(existing);
   if (existingName) {

package/src/mcp/identity/paths.js

@@ -153,3 +153,8 @@ export function defaultClaudecodeConfigPath(env) {
   return path.join(home, '.claude.json');
 }
 
+export function defaultGrokConfigPath(env) {
+  const home = env.USERPROFILE || env.HOME || os.homedir();
+  return path.join(home, '.grok', 'config.toml');
+}
+

package/src/ui/setup.js

@@ -15,6 +15,9 @@ import { profileClientConfig } from '../config/profile.js';
 
 const SETUP_CLIENT_ALIASES = new Map([
   ['codex', 'codex'],
+  ['grok', 'grok'],
+  ['grok-cli', 'grok'],
+  ['grok-build', 'grok'],
   ['cursor', 'cursor'],
   ['copilot', 'copilot-cli'],
   ['copilot-cli', 'copilot-cli'],