XMemo

Name: XMemo
Author: yonro

von yonroVersion 0.4.346i★ –iComputer oder Cloud

Name in der Registryio.github.yonro/xmemo

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi3 von 3 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu↓ 147/Wo. · ★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Computer oder Cloud
Transport: stdio, Streamable HTTP
Kategorie: Suche & KI-Gedächtnis
Das musst du eintragen: XMEMO_KEY, Authorization

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 3 von 3 bestanden
Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
Das trägst du selbst ein: 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

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet
npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Diese Adresse braucht einen Schlüssel in einem Header der Anfrage, und das Menü zum Hinzufügen von Connectors kann ihn nicht setzen. Nutze stattdessen Claude Code, Cursor oder VS Code.

Oder führ ihn auf deinem Computer aus

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

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

Führe das in deinem Terminal aus

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'

Oder führ ihn auf deinem Computer aus

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

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "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"
      }
    }
  }
}

Oder führ ihn auf deinem Computer aus

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "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"
      }
    }
  }
}

Oder führ ihn auf deinem Computer aus

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Diese Adresse braucht einen Schlüssel in einem Header der Anfrage, und das Menü zum Hinzufügen von Connectors kann ihn nicht setzen. Nutze stattdessen Claude Code, Cursor oder VS Code.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

XMEMO_KEY geheim 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 geheim erforderlich 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'.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 9. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto yonro bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
✓ Bestanden
Endpunkt antwortet
Antwort in 220 ms (HTTP 401)
✓ Bestanden
Anmeldung mit OAuth
Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

Mehr Sterne als 0 % der anderen 5746 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 48 % der anderen 5746 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 5746 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist XMemo sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: XMEMO_KEY, Authorization

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.4.346) kam vor 44 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Context7, Codebase Memory, Exa

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Context7

Up-to-date docs for AI agents

von upstashWeit verbreitet↓ 972.664/Wo.★ 64.224Aktualisiert vorgestern

Computer oder Cloud

Installieren

Codebase Memory

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

von DeusDataWeit verbreitet↓ 17.962/Wo.★ 48.148Aktualisiert vor 22 Tagen

Läuft auf deinem Computer

Installieren

Exa

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

von exa-labsWeit verbreitet★ 5213Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ exa.ai

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo

XMemo

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Oder führ ihn auf deinem Computer aus

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

Häufige Fragen

Alternativen

Context7

Codebase Memory

Exa

README vom Entwickler

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`)