@xmemo/client 0.4.163 → 0.4.165

package/LICENSE

@@ -1,7 +1,21 @@
-Copyright (c) Yonro.
+MIT License
 
-All rights reserved.
+Copyright (c) 2025-2026 Yonro
 
-This package is published as a client distribution artifact for XMemo.
-No license is granted to copy, modify, distribute, sublicense, or use the source
-code except as expressly permitted by Yonro in a separate written agreement.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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/bin/mcp-stdio.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * XMemo MCP stdio server — thin local proxy for Glama quality tests and
+ * clients that only support stdio transport.
+ *
+ * Reads XMEMO_KEY and XMEMO_URL from environment, forwards all MCP
+ * JSON-RPC messages to the hosted endpoint over Streamable HTTP.
+ */
+import { spawn } from 'node:child_process';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const mcpRemoteBin = resolve(__dirname, '..', 'node_modules', '.bin', 'mcp-remote');
+const url = process.env.XMEMO_URL
+  ? `${process.env.XMEMO_URL.replace(/\/$/, '')}/mcp`
+  : 'https://xmemo.dev/mcp';
+const token = process.env.XMEMO_KEY ?? '';
+
+const args = [url];
+if (token) {
+  args.push('--header', `Authorization:Bearer ${token}`);
+}
+
+const child = spawn(process.execPath, [mcpRemoteBin, ...args], {
+  stdio: ['inherit', 'inherit', 'inherit'],
+  env: { ...process.env }
+});
+
+child.on('exit', (code) => process.exit(code ?? 1));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmemo/client",
-  "version": "0.4.163",
+  "version": "0.4.165",
   "description": "Privacy-first CLI and MCP setup helper for XMemo.",
   "mcpName": "io.github.yonro/xmemo",
   "type": "module",
@@ -44,5 +44,5 @@
     "cli",
     "privacy"
   ],
-  "license": "UNLICENSED"
+  "license": "MIT"
 }

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,8 +12,10 @@ export {
   defaultCopilotConfigPath,
   defaultCursorConfigPath,
   defaultGeminiConfigPath,
+  defaultGrokConfigPath,
   defaultHermesConfigPath,
   defaultJetbrainsConfigPath,
+  defaultKimiCodeConfigPath,
   defaultKiroConfigPath,
   defaultOpencodeConfigPath,
   defaultOpenclawConfigPath,

package/src/config/profile.js

@@ -131,6 +131,21 @@ export function profileClientConfig(clientId) {
         return path.join(userHome(env), '.kiro', 'steering', 'AGENTS.md');
       }
     },
+    'kimi-code': {
+      label: 'Kimi Code',
+      setupAlias: 'kimi',
+      profileVersion: 'kimi-code-mcp-depth-v1',
+      requiredTokenEnv: TOKEN_ENV_VAR,
+      markerStart: CLIENT_PROFILE_MARKER_START,
+      markerEnd: CLIENT_PROFILE_MARKER_END,
+      defaultTarget: (env) => {
+        const isTest = env.HOME && (env.HOME.includes('memory-os-') || env.HOME.includes('test'));
+        if (!isTest && (existsSync(path.join(process.cwd(), '.kimi-code')) || existsSync(path.join(process.cwd(), '.git')) || existsSync(path.join(process.cwd(), 'package.json')))) {
+          return path.join(process.cwd(), '.kimi-code', 'AGENTS.md');
+        }
+        return path.join(userHome(env), '.kimi-code', 'AGENTS.md');
+      }
+    },
     'gemini-cli': {
       label: 'Gemini CLI',
       setupAlias: 'gemini',
@@ -222,7 +237,7 @@ export function profileClientConfig(clientId) {
 }
 
 export function supportedProfileClientIds() {
-  return ['codex', 'cursor', 'kiro', 'gemini', 'antigravity', 'qwen', 'opencode', 'trae', 'trae-solo'];
+  return ['codex', 'cursor', 'kiro', 'kimi-code', 'gemini', 'antigravity', 'qwen', 'opencode', 'trae', 'trae-solo'];
 }
 
 export function defaultProfileTarget(clientId, env) {

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,8 +25,10 @@ import {
   defaultContinueConfigPath,
   defaultCursorConfigPath,
   defaultGeminiConfigPath,
+  defaultGrokConfigPath,
   defaultHermesConfigPath,
   defaultJetbrainsConfigPath,
+  defaultKimiCodeConfigPath,
   defaultKiroConfigPath,
   defaultOpencodeConfigPath,
   defaultOpenclawConfigPath,
@@ -45,6 +49,9 @@ export const MCP_CLIENTS = createMcpClients({
   defaultCodexConfigPath,
   codexTomlSnippet,
   appendTomlServerConfig,
+  defaultGrokConfigPath,
+  grokTomlSnippet,
+  appendGrokServerConfig,
   defaultHermesConfigPath,
   hermesYamlSnippet,
   mergeHermesMcpConfig,
@@ -64,6 +71,7 @@ export const MCP_CLIENTS = createMcpClients({
   defaultKiroConfigPath,
   defaultZedConfigPath,
   defaultJetbrainsConfigPath,
+  defaultKimiCodeConfigPath,
   defaultOpencodeConfigPath,
   defaultQwenConfigPath,
   defaultTraeConfigPath,

package/src/mcp/formats/json.js

@@ -31,6 +31,7 @@ export const JSON_MCP_CLIENT_DEFINITIONS = Object.freeze([
   commandClientDefinition('claude-desktop', 'Claude Desktop', 'defaultClaudeConfigPath'),
   httpClientDefinition('openclaw', 'OpenClaw', 'defaultOpenclawConfigPath', { urlKey: 'url', authentication: 'env-bearer' }),
   commandClientDefinition('kiro', 'Kiro', 'defaultKiroConfigPath'),
+  httpClientDefinition('kimi-code', 'Kimi Code', 'defaultKimiCodeConfigPath', { urlKey: 'url', authentication: 'env-bearer' }),
   commandClientDefinition('zed', 'Zed', 'defaultZedConfigPath', { section: 'context_servers' }),
   nestedTransportClientDefinition('jetbrains', 'JetBrains', 'defaultJetbrainsConfigPath'),
   remoteClientDefinition('opencode', 'OpenCode', 'defaultOpencodeConfigPath'),
@@ -353,3 +354,8 @@ export const claudecodeJsonSnippet = (mcpUrl, identity = envReferenceIdentity('c
 export const claudecodeJsonServerConfig = (mcpUrl, identity = envReferenceIdentity('claude-code')) => jsonClientServerConfig('claude-code', mcpUrl, identity);
 export const mergeClaudecodeMcpConfig = (configPath, mcpUrl, identity) => mergeJsonClientMcpConfig('claude-code', configPath, mcpUrl, identity);
 
+export const kimiCodeJsonConfig = (mcpUrl, identity = envReferenceIdentity('kimi-code')) => jsonClientConfig('kimi-code', mcpUrl, identity);
+export const kimiCodeJsonSnippet = (mcpUrl, identity = envReferenceIdentity('kimi-code')) => jsonClientSnippet('kimi-code', mcpUrl, identity);
+export const kimiCodeJsonServerConfig = (mcpUrl, identity = envReferenceIdentity('kimi-code')) => jsonClientServerConfig('kimi-code', mcpUrl, identity);
+export const mergeKimiCodeMcpConfig = (configPath, mcpUrl, identity) => mergeJsonClientMcpConfig('kimi-code', configPath, mcpUrl, identity);
+

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,13 @@ 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');
+}
+
+export function defaultKimiCodeConfigPath(env) {
+  const home = env.USERPROFILE || env.HOME || os.homedir();
+  return path.join(home, '.kimi-code', 'mcp.json');
+}
+

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'],
@@ -31,6 +34,9 @@ const SETUP_CLIENT_ALIASES = new Map([
   ['claude-desktop', 'claude-desktop'],
   ['openclaw', 'openclaw'],
   ['kiro', 'kiro'],
+  ['kimi', 'kimi-code'],
+  ['kimi-code', 'kimi-code'],
+  ['kimi-cli', 'kimi-code'],
   ['zed', 'zed'],
   ['jetbrains', 'jetbrains'],
   ['opencode', 'opencode'],