# Universal Memory

Universal Memory (UMem) is a vendor-agnostic, local-first persistence layer for AI agents. It keeps project context, durable preferences, operating rules, and reusable Agent Skills portable across supported coding assistants.

- Website: <https://universal-memory.com/>
- Documentation: <https://docs.universal-memory.com/>
- Source: <https://github.com/YanAmorelli/universal-memory>
- Package: <https://pypi.org/project/universal-memory/>

## What it provides

- Project and global memory scopes.
- Explicit fact capture, inspection, deletion, audit, snapshots, and rollback.
- Host integration for Claude Code, Codex, OpenCode, Cursor, and Antigravity/Gemini.
- A local Model Context Protocol server over `stdio`.
- Canonical Agent Skills synchronized to supported runtimes.

## Try it

Run without a permanent install:

```bash
uvx --from universal-memory umem --help
```

For ongoing use:

```bash
uv tool install universal-memory
```

After the user authorizes initialization of the current repository:

```bash
umem init --runtime codex
umem status
```

## Local MCP server

Launch the MCP server with:

```bash
uvx --from universal-memory umem-mcp
```

The public Server Card describes this local `stdio` transport; it does not advertise a hosted MCP endpoint.

## Agent discovery

- [MCP Server Card](https://universal-memory.com/.well-known/mcp/server-card.json)
- [Agent Skills index](https://universal-memory.com/.well-known/agent-skills/index.json)
- [Setup skill](https://universal-memory.com/.well-known/agent-skills/universal-memory-setup/SKILL.md)

Human-facing localized pages are available in [English](https://universal-memory.com/en), [Portuguese](https://universal-memory.com/pt), and [Spanish](https://universal-memory.com/es).