[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_125":126},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":82,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","yonro","moduleId","memory-os-cli","@yonro/memory-os-cli","displayName","XMemo","tagline","Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.","iconKey","https://avatars.githubusercontent.com/u/52488142?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://xmemo.dev/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\",\"requiredSecrets\":[\"X_MEMORY_OS_AGENT_ID\",\"X_MEMORY_OS_AGENT_INSTANCE_ID\",\"X_MEMORY_OS_DEVICE_ID\",\"X_MEMORY_OS_DEVICE_LABEL\"]}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783399324000,"updatedAt",1788069899000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.yonro%2Fxmemo","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",12,"upstreamUpdatedAt",1788069843000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/yonro/memory-os-cli","githubRepoFullName","yonro/memory-os-cli","releaseId","ext-yonro-memory-os-cli","version","0.4.345","descriptionMarkdown","

\n \n $\"XMemo$ \n \n\n

XMemo CLI

\n\n

One private memory layer for every AI agent.

\n Install, authenticate, diagnose, and connect XMemo across editors,\n CLIs, and autonomous agents from one production-ready command line.\n

\n\n

\n $\"CI\"$ \n $\"npm$ \n $\"npm$ \n $\"Node.js$ \n $\"MIT$ \n $\"GitHub$ \n

\n\n

\n $\"MCP$ \n $\"XMemo$ \n $\"Privacy$ \n $\"MCP$ \n $\"Glama$ \n

\n\n

\n Quick start ·\n Integrations ·\n Connection modes ·\n Commands ·\n Security\n

\n\n---\n\n`@xmemo/client` is the official control plane for connecting AI tools to\n[XMemo](https://xmemo.dev). It makes setup repeatable, keeps credentials out of\nproject files, and gives every supported client a consistent path to durable,\nuser-owned memory.\n\nThe package is deliberately small: the CLI runtime, safe client configuration,\nbehavior profiles, XMemo skills, and marketplace metadata. Server code,\ndatabases, deployment files, logs, and internal operations remain outside the\nnpm distribution.\n\n## Architecture\n\n

\n $\"XMemo$ \n

\n\n| | |\n| --- | --- |\n| **Package** | [`@xmemo/client`](https://www.npmjs.com/package/@xmemo/client) |\n| **Primary command** | `xmemo` |\n| **Local MCP command** | `xmemo-mcp` |\n| **Hosted MCP** | `https://xmemo.dev/mcp` |\n| **Runtime** | Node.js 20 or later |\n| **License** | MIT |\n\n## Why XMemo CLI\n\n- **One control plane** — login, diagnostics, configuration, profiles, updates,\n and smoke checks share one predictable interface.\n- **Private by design** — generated project configuration references a\n credential; it never embeds the credential value.\n- **Native where it matters** — OpenClaw and Hermes use dedicated memory\n integrations instead of duplicating the same capability through MCP.\n- **Portable everywhere else** — hosted Streamable HTTP MCP and local stdio\n cover modern editors, terminals, and agent runtimes.\n- **Safe automation** — supported setup and removal paths offer preview,\n dry-run, or explicit confirmation before making changes.\n- **Small supply-chain surface** — the npm package is governed by an explicit\n file allowlist and release provenance.\n\n## Quick start\n\n```bash\nnpm install -g @xmemo/client\nxmemo login\nxmemo doctor\nxmemo setup codex\nxmemo status\n```\n\nReplace `codex` with your client. Preview a configuration before writing it:\n\n```bash\nxmemo setup cursor --dry-run\n```\n\n

\n $\"XMemo$ \n

\n\n> [!TIP]\n> Start with `xmemo login`, `xmemo doctor`, and `xmemo setup `.\n> Hand-edit MCP configuration only when a client has no verified setup path.\n\n## Supported integrations\n\n| Client | Recommended command | Connection |\n| --- | --- | --- |\n| **Codex** | `xmemo setup codex` | Hosted MCP + behavior profile |\n| **Cursor** | `xmemo setup cursor` | Hosted MCP + behavior profile |\n| **Copilot CLI** | `xmemo setup copilot` | Local authenticated proxy |\n| **Gemini CLI** | `xmemo setup gemini` | Hosted MCP + OAuth |\n| **Antigravity** | `xmemo setup antigravity` | Hosted MCP + OAuth |\n| **OpenClaw** | `xmemo setup openclaw` | Native memory plugin + Skill |\n| **Hermes** | `xmemo setup hermes` | Native memory provider |\n| **Kiro** | `xmemo setup kiro` | Hosted MCP |\n| **Grok** | `xmemo setup grok` | Hosted MCP |\n| **Other MCP clients** | `xmemo mcp config --client generic` | Generated template |\n\nThe client registry also covers Windsurf, Cline, Continue, Claude Desktop,\nClaude Code, Kimi Code, Zed, JetBrains, OpenCode, Qwen, Trae, and compatible\nMCP hosts. Run `xmemo mcp list` for the current machine-readable catalog.\n\n## Connection modes\n\n### Hosted MCP\n\nThe recommended universal path is the XMemo Streamable HTTP endpoint:\n\n```text\nhttps://xmemo.dev/mcp\n```\n\nOAuth-capable clients complete authentication in the browser. Other clients\nreference `XMEMO_KEY` without copying its value into repository files.\n\nGeneric configuration shape:\n\n```json\n{\n \"mcpServers\": {\n \"XMemo\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://xmemo.dev/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer ${XMEMO_KEY}\"\n }\n }\n }\n}\n```\n\nClient configuration keys differ; prefer `xmemo setup ` over copying\nthis generic example directly.\n\n### Local stdio MCP\n\n`xmemo-mcp` is the dedicated stdio entry point for marketplaces and clients\nthat launch a local process. Safe discovery exposes 20 tools, three prompts,\nand two documentation resources without a token. Tool execution still requires\nauthentication.\n\nAfter a global installation:\n\n```bash\nxmemo-mcp\n```\n\nInstall-free MCP configuration:\n\n```json\n{\n \"mcpServers\": {\n \"XMemo\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"--package\",\n \"@xmemo/client@latest\",\n \"xmemo-mcp\"\n ]\n }\n }\n}\n```\n\n`xmemo mcp serve` is equivalent when the CLI is already installed.\n\n### Native integrations\n\nOpenClaw and Hermes have dedicated memory providers. Their default setup avoids\ninstalling a second, duplicate XMemo tool surface.\n\n```bash\n# Native OpenClaw plugin + XMemo Skill\nxmemo setup openclaw\n\n# Native Hermes memory provider\nxmemo setup hermes\n```\n\nAdd hosted MCP only when an explicit fallback is desired:\n\n```bash\nxmemo setup openclaw --with-mcp\nxmemo setup hermes --with-mcp\n```\n\nUse `--mcp-only` to skip the native integration and install only the hosted MCP\nfallback.\n\n## Authentication\n\n### Browser login\n\nRecommended for personal accounts:\n\n```bash\nxmemo login\nxmemo auth status\n```\n\nThe CLI uses the hosted device-login flow, waits for browser approval, and\nasks once before storing the issued credential unencrypted in the current\nuser's XMemo config directory. The exact path is shown before approval, file\npermissions are restricted where the operating system supports it, and the\ncredential value is never printed. Prefer `XMEMO_KEY` or a managed secret store\non shared systems.\n\nFor non-interactive automation, record the same decision explicitly:\n\n```bash\nxmemo login --allow-plaintext\n```\n\n### Existing token\n\nPipe an existing token through stdin so it does not appear in command history:\n\n```bash\nprintf '%s\\n' 'your-token' | xmemo token add --from-stdin --allow-plaintext\nxmemo token status --verify\n```\n\nPowerShell:\n\n```powershell\n$xmemoToken = Read-Host \"XMemo token\"\n$xmemoToken | xmemo token add --from-stdin --allow-plaintext\nRemove-Variable xmemoToken\n```\n\nFor CI and managed workstations, expose `XMEMO_KEY` through the platform's\nsecret manager. Do not commit it to `.env`, MCP configuration, logs, issue\nreports, or chat transcripts.\n\n## Command reference\n\n

Lifecycle and diagnostics

\n\n```bash\nxmemo --version\nxmemo update\nxmemo update --dry-run\nxmemo doctor\nxmemo discovery show\nxmemo status\nxmemo privacy\n```\n\n

\n\n

Authentication

\n\n```bash\nxmemo login\nxmemo auth status\nxmemo auth-status --verify\nxmemo token status --verify\nxmemo token add --from-stdin --allow-plaintext\nxmemo env example --shell bash\n```\n\n

\n\n

Client setup

\n\n```bash\nxmemo setup \nxmemo setup --dry-run\nxmemo setup --all\nxmemo setup openclaw [--with-mcp|--mcp-only]\nxmemo setup hermes [--with-mcp|--mcp-only]\n```\n\n

\n\n

MCP and behavior profiles

\n\n```bash\nxmemo mcp serve\nxmemo mcp list\nxmemo mcp config --client generic\nxmemo mcp add --write\nxmemo mcp proxy\nxmemo profile install \nxmemo profile status \nxmemo profile uninstall \nxmemo smoke --client codex\n```\n\n

\n\n

Safe removal

\n\n```bash\nxmemo uninstall --dry-run\nxmemo uninstall --yes\nxmemo uninstall --all --dry-run\nxmemo uninstall --all --yes --profiles\n```\n\nOnly XMemo-owned entries and marker-scoped behavior profiles are removed.\nUnrelated MCP servers, credentials, and device identity remain intact.\n\n

\n\nRun `xmemo help` or `xmemo --help` for complete, version-matched\noptions.\n\n## Client notes\n\n

Codex and Cursor

\n\n```bash\nxmemo setup codex\nxmemo smoke --client codex\n\nxmemo setup cursor\n```\n\nBoth setup paths write a user-scoped MCP entry and can install a marker-scoped\nmemory behavior profile. Use `--no-profile` to configure MCP only. Cursor's\npublic marketplace plugin remains OAuth-first and contains no bearer-token\nconfiguration.\n\n

\n\n

Gemini CLI and Antigravity

\n\n```bash\nxmemo setup gemini\nxmemo setup antigravity\n```\n\nThese clients use hosted MCP OAuth. Their generated configuration carries no\ntoken value; restart the client and complete the browser login on first use.\n\n

\n\n

OpenClaw

\n\n```bash\nxmemo login\nxmemo setup openclaw\nopenclaw xmemo status\n```\n\nThe setup command installs or updates `@xmemo/openclaw-memory`, installs the\nXMemo Skill, reuses the shared XMemo credential, and checks plugin status.\n\n

\n\n

Hermes

\n\n```bash\nxmemo login\nxmemo setup hermes\n```\n\nThe setup command installs or updates `hermes-xmemo`, configures the native\nprovider, and synchronizes the user-scoped XMemo credential with Hermes.\n\n

\n\n

Copilot CLI

\n\n```bash\nxmemo login\nxmemo setup copilot\nxmemo mcp proxy\n```\n\nCopilot CLI receives a local proxy entry. The proxy reads the credential from\nuser-scoped storage, adds identity metadata, and forwards requests to hosted\nMCP without writing secrets into Copilot configuration.\n\n

\n\n## Security by default\n\n| Control | Default behavior |\n| --- | --- |\n| **Telemetry** | No CLI analytics or usage telemetry |\n| **Credential output** | Token values are never printed |\n| **Project files** | Generated configuration references secrets; it does not embed them |\n| **Discovery** | `doctor`, `discovery show`, and public capability discovery send no token |\n| **Identity** | One stable, non-secret agent-instance ID is stored outside git |\n| **Writes** | Setup supports preview/dry-run; broad removal requires confirmation |\n| **Local credential storage** | Interactive login asks first; non-interactive writes require `--allow-plaintext`; stored tokens are unencrypted |\n| **Package contents** | An npm `files` allowlist excludes tests, operations, logs, and server code |\n\nCredential precedence and compatibility aliases are documented by:\n\n```bash\nxmemo env example --shell bash\nxmemo privacy\n```\n\nFor private or self-hosted deployments, set `XMEMO_URL` or pass\n`--url `. `MEMORY_OS_URL` remains a compatibility alias.\n\n## Package boundary\n\nPublished to npm:\n\n```text\nbin/\ndocs/assets/\nsrc/\nskills/\nplugins/kiro/\nplugins/xmemo/\nREADME.md\nLICENSE\n```\n\nNot published:\n\n```text\n.github/\ndocs/analysis/\ndocs/architecture/\ntest/\ncoverage/\nserver code\ndatabase migrations\ndeployment files\nlogs and local state\n```\n\n## Development\n\n```bash\nnpm install\nnpm run release:check\nnpm run lint\nnpm test\nnpm run pack:dry-run\n```\n\nBefore proposing a release, run the complete package gate:\n\n```bash\nnpm run prepublishOnly\n```\n\nThe local stdio server can be inspected directly:\n\n```bash\nnode bin/mcp-stdio.js\n```\n\n## Release model\n\nNormal releases are produced by GitHub Actions from the exact tagged commit,\nnot from a mutable branch checkout or a developer workstation:\n\n```text\ndevelop → CLI version sync → test → cli-v tag → GitHub Actions → npm publish --provenance\n```\n\nThe CLI package and hosted MCP service intentionally have separate version\nstreams:\n\n- CLI/npm version: `package.json`, `package-lock.json`, and the npm package\n entry in `server.json`.\n- Hosted MCP/Registry version: the top-level `server.json.version` and\n `lhm.plugin.json`. This version follows the deployed XMemo service.\n\n`node scripts/check-release-version.mjs` verifies both contracts. A\n`cli-vX.Y.Z` tag must equal the CLI/npm version and publishes only npm. The\nMCP Registry is published separately with the `Publish MCP Registry metadata`\nworkflow using `mcp-vX.Y.Z`, which must equal the hosted MCP/Registry version.\nThe separate npm publish workflow is manual recovery only, so creating a\nGitHub Release cannot publish twice.\n\n## Documentation and support\n\nCanonical service documentation lives at [xmemo.dev/docs](https://xmemo.dev/docs/quickstart).\nThis repository documents the client; the pages below document the hosted service\nit connects to.\n\n| | |\n| --- | --- |\n| **Quickstart** | [xmemo.dev/docs/quickstart](https://xmemo.dev/docs/quickstart) |\n| **MCP overview and per-client setup** | [xmemo.dev/docs/mcp/overview](https://xmemo.dev/docs/mcp/overview) |\n| **Tool reference** (`remember`, `recall`, `search`, …) | [xmemo.dev/docs/tools/remember](https://xmemo.dev/docs/tools/remember) |\n| **REST API** | [xmemo.dev/docs/api/authentication](https://xmemo.dev/docs/api/authentication) |\n| **Troubleshooting** | [xmemo.dev/docs/troubleshooting](https://xmemo.dev/docs/troubleshooting) |\n| **Machine-readable index** | [xmemo.dev/llms.txt](https://xmemo.dev/llms.txt) |\n\n- [XMemo](https://xmemo.dev)\n- [MCP server reference](https://github.com/yonro/memory-os-cli/blob/main/MCP-README.md)\n- [Adding a new client](https://github.com/yonro/memory-os-cli/blob/main/ADDING_CLIENTS.md)\n- [Issues](https://github.com/yonro/memory-os-cli/issues)\n- [Releases](https://github.com/yonro/memory-os-cli/releases)\n\n## License\n\n[MIT](https://github.com/yonro/memory-os-cli/blob/main/LICENSE) © 2025–2026 Yonro\n","changelogMarkdown","videoKey","requiredSecretsJson","[\"X_MEMORY_OS_AGENT_ID\",\"X_MEMORY_OS_AGENT_INSTANCE_ID\",\"X_MEMORY_OS_DEVICE_ID\",\"X_MEMORY_OS_DEVICE_LABEL\"]","publishedAt","priceCents","trialDays",0,"upstream",{"_104":105,"_106":107,"_108":109,"_110":111,"_112":113,"_114":115},"requiredSecrets",[100,101,102,103],"tags",[99,63],"assets",[],"stats",{"_97":86,"_98":86},"ratingAvg","reviewCount","ai-memory","X_MEMORY_OS_AGENT_ID","X_MEMORY_OS_AGENT_INSTANCE_ID","X_MEMORY_OS_DEVICE_ID","X_MEMORY_OS_DEVICE_LABEL","topics",[99,122,123,124,63],"license","MIT","language","JavaScript","registryName","io.github.yonro/xmemo","homepage","https://xmemo.dev/product/mcp","packages",[116],{"_117":118,"_119":120,"_75":121},"registryType","npm","identifier","@xmemo/client","0.4.181","mcp","mcp-server","model-context-protocol","ENV",{"_127":128,"_129":130,"_131":132},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]