XMemo

Name: XMemo
Author: yonro

de yonroversión 0.4.346i★ –iComputadora o nube

Nombre en el registroio.github.yonro/xmemo

Instalar

Resumen

Descripción del creador (original en inglés)

Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi3 de 3 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 147/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Computadora o nube
Transporte: stdio, Streamable HTTP
Categoría: Búsqueda y memoria de IA
Debes completar: XMEMO_KEY, Authorization

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 3 de 3 superadas
Se ejecuta en el servidor del creador: lo que le pidas pasa por su servidor.
Debes completar tú: XMEMO_KEY, XMEMO_URL, Authorization, X-Memory-OS-Agent-ID, X-Memory-OS-Agent-Instance-ID, X-Memory-OS-Device-ID, X-Memory-OS-Device-Label

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

Se ejecuta en la nubeNo hay nada que instalar; se conecta por internet
npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Esta dirección necesita una clave en un header de la solicitud, y el menú para agregar conectores no puede ponerla. Usa Claude Code, Cursor o VS Code.

O ejecútalo en tu computadora

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "xmemo": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "your-value",
        "XMEMO_URL": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add --transport http xmemo https://xmemo.dev/mcp --header 'Authorization: your-value' --header 'X-Memory-OS-Agent-ID: your-value' --header 'X-Memory-OS-Agent-Instance-ID: your-value' --header 'X-Memory-OS-Device-ID: your-value' --header 'X-Memory-OS-Device-Label: your-value'

O ejecútalo en tu computadora

claude mcp add xmemo --env XMEMO_KEY=your-value --env XMEMO_URL=your-value -- npx -y @xmemo/client mcp serve

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "xmemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "your-value",
        "X-Memory-OS-Agent-ID": "your-value",
        "X-Memory-OS-Agent-Instance-ID": "your-value",
        "X-Memory-OS-Device-ID": "your-value",
        "X-Memory-OS-Device-Label": "your-value"
      }
    }
  }
}

O ejecútalo en tu computadora

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "xmemo": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "your-value",
        "XMEMO_URL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "your-value",
        "X-Memory-OS-Agent-ID": "your-value",
        "X-Memory-OS-Agent-Instance-ID": "your-value",
        "X-Memory-OS-Device-ID": "your-value",
        "X-Memory-OS-Device-Label": "your-value"
      }
    }
  }
}

O ejecútalo en tu computadora

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "xmemo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "your-value",
        "XMEMO_URL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Esta dirección necesita una clave en un header de la solicitud, y el menú para agregar conectores no puede ponerla. Usa Claude Code, Cursor o VS Code.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

XMEMO_KEY secreto env
Bearer token issued by XMemo for the stdio proxy. Optional for discovery; required for tool execution.
XMEMO_URL env
Optional XMemo service base URL. Defaults to https://xmemo.dev.
Authorization secreto obligatorio HTTP header
Bearer token issued by XMemo; send as an Authorization Bearer value.
X-Memory-OS-Agent-ID HTTP header
Optional stable agent family id for attribution, for example 'claude-code' or 'copilot-cli'.
X-Memory-OS-Agent-Instance-ID HTTP header
Optional stable local installation id for attribution; XMemo hashes it server-side.
X-Memory-OS-Device-ID HTTP header
Optional stable local device id for attribution; use a non-secret machine or installation identifier.
X-Memory-OS-Device-Label HTTP header
Optional human-readable local device label for attribution, for example 'MacBook Pro' or 'PC A'.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 10 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub yonro, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
✓ Superada
El endpoint responde
Respondió en 220 ms (HTTP 401)
✓ Superada
Inicio de sesión con OAuth
Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Comparado con otros en Búsqueda y memoria de IAi

Más estrellas que el 0% de los otros 5832 servidores de esta categoría
Publicado en el registro más recientemente que el 47% de los otros 5832 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 5832 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro XMemo?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: XMEMO_KEY, Authorization

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.4.346) llegó al registro el mes pasado.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.

¿Qué puedo usar en su lugar?

En la misma categoría: Context7, Codebase Memory, Exa

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Context7

Up-to-date docs for AI agents

de upstashMuy usado↓ 972,7 mil/sem★ 64,2 milActualizado hoy

Computadora o nube

Instalar

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

de DeusDataMuy usado↓ 18 mil/sem★ 48,1 milActualizado hace 23 días

Se ejecuta en tu computadora

Instalar

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

de exa-labsMuy usado★ 5,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ exa.ai

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

XMemo: Memory OS for AI Agents

XMemo is a user-owned Memory OS for AI agents: persistent memory, project context and session continuity with agent identity, provenance and governed access, shared across AI clients through MCP, the CLI and a public REST API surface.

English · 简体中文 | Documentation · Hosted MCP

Quick start · What this repo contains · Beyond MCP · Integrations · Connection modes · Plugins · Commands · Versioning · Security

What this repository contains

[`@xmemo/client`](https://www.npmjs.com/package/@xmemo/client): the official xmemo CLI for setup, diagnostics, behavior profiles, and memory commands.
MCP distribution: hosted Streamable HTTP configuration (https://xmemo.dev/mcp) and the local xmemo-mcp stdio server.
XMemo Skill & native integrations: skills/xmemo for agent platforms and the native plugin index (src/plugins/index.json).
Marketplace and registry metadata: canonical descriptors for MCP Registry (server.json), LobeHub (lhm.plugin.json), and AI agents (context7.json).

The hosted service implementation is private.

Beyond MCP

MCP is one access surface of XMemo, not the product boundary. XMemo provides a persistent, governed memory operating layer across AI tools and agents:

[Persistent Memory](https://docs.xmemo.dev/docs/tools/remember): store, search, list, and soft-delete durable facts, preferences, and operational knowledge across sessions.
[Context Recall](https://docs.xmemo.dev/docs/tools/recall-context): retrieve focused, relevant context on demand with token-budget controls and document expansions.
[Session Continuity & Working State](https://docs.xmemo.dev/docs/guides/resume-and-handoff): restart snapshots and state save/restore so agents resume context across process restarts.
[Project Context & Decisions](https://docs.xmemo.dev/docs/concepts/projects): track project-scoped facts, TODOs, and durable decisions across agent workflows.
[Agent Identity & Provenance](https://docs.xmemo.dev/docs/concepts/provenance-attribution): track authorship and origin per memory record via agent instance attribution without conflating credentials.
[Governed Access](https://docs.xmemo.dev/docs/concepts/scopes): scoped tokens, OAuth where the client supports it, soft/hard deletion and sensitive-memory handling (governance details).
Native Integrations & Skill: dedicated integration for OpenClaw, Hermes, XMemo Skill (ClawHub), and DeepSeek DSH (available, released and pilot-tested; integration maturity Preview).
Access Surfaces: unified via Model Context Protocol, the local CLI (xmemo), and the public REST API.

*Preview: Cloud Skills; Dream (off by default); Teams (Business plan not yet available). Knowledge Bases are available where enabled for the account.*

XMemo CLI

@xmemo/client is the official control plane for connecting AI tools to XMemo. It makes setup repeatable, keeps credentials out of project files, and gives every supported client a consistent path to durable, user-owned memory.

The package is deliberately small: the CLI runtime, safe client configuration, behavior profiles, XMemo skills, and marketplace metadata. Server code, databases, deployment files, logs, and internal operations remain outside the npm distribution.

Architecture


Package	`@xmemo/client`
Primary command	`xmemo` (alias: `client`)
Local MCP command	`xmemo-mcp`
Hosted MCP	`https://xmemo.dev/mcp`
Runtime	Node.js 20 or later
License	MIT

Why XMemo CLI

One control plane — login, diagnostics, configuration, profiles, updates, and smoke checks share one predictable interface.
Private by design — generated project configuration references a credential; it never embeds the credential value.
Native where it matters — OpenClaw and Hermes use dedicated memory integrations instead of duplicating the same capability through MCP.
Portable everywhere else — hosted Streamable HTTP MCP and local stdio cover modern editors, terminals, and agent runtimes.
Safe automation — supported setup and removal paths offer preview, dry-run, or explicit confirmation before making changes.
Small supply-chain surface — the npm package is governed by an explicit file allowlist and release provenance.

Quick start

Guided onboarding (`xmemo init`)

For an interactive first-run experience across account authentication, detected clients, agent behavior instructions, MCP server setup, skills, and plugins, run:

npm install -g @xmemo/client

xmemo init

Flags and options:

xmemo init --dry-run: View the full onboarding plan without performing network calls or disk writes.
xmemo init --yes: Automatically accept and apply all onboarding steps without interactive prompts.
xmemo init --json: Emit structured JSON for the plan or result envelope.
xmemo init --client ...: Restrict onboarding to specific clients (e.g., cursor, codex, claude-code).
xmemo start: Alias for xmemo init with quick-start walkthrough steps.

Global installation exposes xmemo as the primary command, and also provides client and memory-os as aliases.

Manual step-by-step setup

xmemo account login

xmemo doctor xmemo setup codex xmemo status

Replace codex with your client. Preview a configuration before writing it:

xmemo setup cursor --dry-run

Running with npx

You can also run any CLI command directly without a global install via npx @xmemo/client :

# Check version or health

npx @xmemo/client --version npx @xmemo/client doctor

Guided onboarding without global install

npx @xmemo/client init

Install skill or run MCP stdio server

npx @xmemo/client skill install npx @xmemo/client mcp serve

[!TIP]

Start with xmemo init (or xmemo account login, xmemo doctor, and xmemo setup ).

Hand-edit MCP configuration only when a client has no verified setup path.

How the commands fit together

The XMemo CLI architecture is built on four core design principles:

1. Unified Resource Grammar (`xmemo` )

Every integration component is a first-class resource with predictable lifecycle actions:

Resource	Scope	Actions	Examples
`mcp`	MCP server connection configuration	`install`, `remove`, `status`	`xmemo mcp install codex`, `xmemo mcp status`
`plugin`	Host-native extension packages	`install`, `remove`, `status`, `list`, `info`	`xmemo plugin install gemini-cli`, `xmemo plugin list`
`skill`	Agent skill scripts & documentation	`install`, `remove`, `status`, `update`	`xmemo skill install --client openclaw`
`profile`	Markdown behavior steering instructions	`install`, `remove`, `status`, `show`	`xmemo profile install cursor`

Composite commands: xmemo setup [ ...], xmemo uninstall [ ...], and xmemo status [ ] orchestrate these resources in a single step according to the client's declarative profile.
Backward-compatible aliases: Familiar commands such as xmemo mcp add (alias for mcp install), xmemo profile uninstall (alias for profile remove), and xmemo skill uninstall (alias for skill remove) remain fully functional and print a helpful one-line hint in interactive terminals.

2. Unified Target Resolver

When no client is explicitly passed, the CLI uses a deterministic three-tier precedence resolution model:

Explicit flag or argument: --client , positional client argument, or --all.
Calling agent environment: Automatically identifies the calling agent runtime when running inside an agent session (e.g., CLAUDECODE / CLAUDE_CODE_ENTRYPOINT maps to claude-code, and CODEX_THREAD_ID / CODEX_SESSION_ID maps to codex).
Detected installed clients: Inspects local configuration paths and markers. If exactly one matching client is found, it is automatically selected; if multiple clients are found in interactive mode, an interactive picker is presented. The CLI never silently writes configuration to arbitrary unverified paths.

3. Plan, Confirm Once, Apply (`PlanRunner`)

Mutating commands follow a strict, atomic execution pattern:

Build Plan: Assemble an ordered sequence of actions across resources (e.g. plugin install followed by skill configuration).
Preview: Print the entire plan (including modified paths, commands, and unified diffs) to the terminal.
Confirm Once: Prompt [y/N] exactly once for the entire sequence. Re-running with --yes or -y bypasses the prompt; --dry-run displays the preview without mutation.
Apply Sequentially: Steps run in dependency order, stopping immediately upon first failure. Re-running an already configured client detects that all components are up to date and reports Nothing to do.

4. Declarative Client Registry

All client configurations, recipes, and capabilities are declared centrally in src/clients/registry.js. Command implementations are purely generic orchestrators with zero hardcoded client ID strings. Platforms can also be added dynamically at runtime via registerClient().

Supported integrations

Client	Recommended command	Connection
Codex	`xmemo setup codex`	Hosted MCP + behavior profile
Cursor	`xmemo setup cursor`	Hosted MCP + Bearer Token + behavior profile
Copilot CLI	`xmemo setup copilot`	Local authenticated proxy

Solo se muestra el principio; lee el resto en el repo

XMemo

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

O ejecútalo en tu computadora

O ejecútalo en tu computadora

O ejecútalo en tu computadora

O ejecútalo en tu computadora

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Búsqueda y memoria de IAi

Preguntas frecuentes

Alternativas

Context7

Codebase Memory

Exa

README del creador

XMemo: Memory OS for AI Agents

What this repository contains

Beyond MCP

XMemo CLI

Architecture

Why XMemo CLI

Quick start

Guided onboarding (xmemo init)

Manual step-by-step setup

Running with npx

Guided onboarding without global install

Install skill or run MCP stdio server

How the commands fit together

1. Unified Resource Grammar (xmemo )

2. Unified Target Resolver

3. Plan, Confirm Once, Apply (PlanRunner)

4. Declarative Client Registry

Supported integrations

Guided onboarding (`xmemo init`)

1. Unified Resource Grammar (`xmemo` )

3. Plan, Confirm Once, Apply (`PlanRunner`)