# XMemo

Persists facts, decisions, and task lists across coding sessions through local stdio or hosted MCP endpoints.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: yonro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yonro/memory-os-cli
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/xmemo

## What it does

XMemo provides a persistent context layer for development agents. It tracks project facts, pending tasks, and architectural decisions, returning relevant details within specified token limits. The system stamps memory entries with agent identity to preserve origin records.

Running the local CLI runner requires Node.js version 20 or newer. While the `@xmemo/client` library is published under the MIT license, the hosted backend remains private. A valid `XMEMO_KEY` token is required to establish communication with the storage layer.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://xmemo.dev/mcp`
- Environment variables: `XMEMO_KEY`, `XMEMO_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env XMEMO_KEY=<XMEMO_KEY> --env XMEMO_URL=<XMEMO_URL> --transport stdio xmemo -- npx -y @xmemo/client
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http xmemo https://xmemo.dev/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add xmemo --url https://xmemo.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add xmemo --env XMEMO_KEY=<XMEMO_KEY> --env XMEMO_URL=<XMEMO_URL> -- npx -y @xmemo/client
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xmemo": {
            "url": "https://xmemo.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xmemo": {
            "command": "npx",
            "args": [
                "-y",
                "@xmemo/client"
            ],
            "env": {
                "XMEMO_KEY": "<XMEMO_KEY>",
                "XMEMO_URL": "<XMEMO_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xmemo": {
            "type": "http",
            "url": "https://xmemo.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xmemo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@xmemo/client"
            ],
            "env": {
                "XMEMO_KEY": "<XMEMO_KEY>",
                "XMEMO_URL": "<XMEMO_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http xmemo https://xmemo.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e XMEMO_KEY=<XMEMO_KEY> -e XMEMO_URL=<XMEMO_URL> xmemo npx -y @xmemo/client
```
Replace <…> with your own values

## When to use it
- persist project state and task lists across agent reboots
- share memory across editors and terminal clients
- retrieve scoped context under tight token budgets
- track record origins by tagging specific agent instances

## Example prompts
- Save our module architecture decisions to XMemo
- Fetch project tasks and past architectural decisions from XMemo

## Similar
- [supermemory-cli](https://affpapa.org/en/nevibecode/skills/supermemory-cli.md) — skill · 470 installs
- [claude-mem](https://affpapa.org/en/nevibecode/plugins/claude-mem.md) — plugin · ★ 103455
- [remember](https://affpapa.org/en/nevibecode/skills/rohitg00-remember.md) — skill · 14000 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/rohitg00-handoff.md) — skill · 13400 installs
- [wrap-up](https://affpapa.org/en/nevibecode/skills/codewithmukesh-wrap-up.md) — skill · 2800 installs
- [self-improvement](https://affpapa.org/en/nevibecode/skills/self-improvement.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md