# EverMe

> Open-source CLI and Agent plugin suite for EverMe — cross-device, cross-Agent personal memory for AI Agents.

- **Type:** MCP server
- **Install:** `agentstack add mcp-evermind-ai-everme`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [EverMind-AI](https://agentstack.voostack.com/s/evermind-ai)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [EverMind-AI](https://github.com/EverMind-AI)
- **Source:** https://github.com/EverMind-AI/EverMe
- **Website:** https://evermind.ai/everme

## Install

```sh
agentstack add mcp-evermind-ai-everme
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# EverMe

  
  
  
  

**Open-source CLI and Agent plugin suite for [EverMe](https://evermind.ai/everme) — cross-device, cross-Agent personal memory for AI Agents.**

[Product](https://evermind.ai/everme) · [Website](https://evermind.ai) · [EverOS engine](https://github.com/EverMind-AI/EverOS) · [Documentation](https://docs.evermind.ai/introduction) · [中文](README.zh.md)

  Table of Contents

- [Project Overview](#project-overview)
- [Quick Start](#quick-start)
- [What's Inside](#whats-inside)
- [Use It With Your Agent](#use-it-with-your-agent)
- [Architecture](#architecture)
- [Development](#development)
- [Public Contracts](#public-contracts)
- [Security](#security)
- [Contributing](#contributing)
- [License](#license)

## Project Overview

**EverMe** is your digital twin powered by a memory that's truly yours. Every conversation becomes experience; every experience becomes mastery — the Agent evolution loop.

This repository ships the **client-side toolchain** that connects any AI Agent — Claude Code, Cursor, Codex, Hermes, OpenClaw, and others — to the EverMe memory layer. The managed service and the EverOS memory engine live separately:

| Layer | What it gives you | Where it lives |
| :--- | :--- | :--- |
| **EverMe CLI + plugins** (this repo) | Auth, plugin install, MCP server, Agent hooks | `EverMind-AI/EverMe` (Apache-2.0) |
| **EverOS** memory engine | The long-term memory operating system | [EverMind-AI/EverOS](https://github.com/EverMind-AI/EverOS) (open source) |
| **EverMe managed service** | Hosted backend, account, billing | [evermind.ai/everme](https://evermind.ai/everme) |

You can run EverMe fully against the managed service today, or self-host the EverOS engine and point the CLI at your own endpoint via `EVERME_API_BASE`.

## Quick Start

### Easiest — let your Agent install it for you

Paste this single line into any AI Agent you already use locally (Claude Code, Cursor, Codex, …):

```text
Read https://everme.evermind.ai/SKILL.md and follow the instruction to install and configure EverMe.
```

The Agent fetches the skill, installs the CLI, walks you through login, and registers the plugin for itself — no manual steps.

### Manual install

```bash
# 1. Install the CLI
npm install -g @everme/cli

# 2. Authenticate (opens browser for Device Flow)
evercli auth login

# 3. Plug your Agent into EverMe — pick one or more:
evercli plugin install claude-code
evercli plugin install claude-desktop
evercli plugin install codex
evercli plugin install cursor
evercli plugin install gemini
evercli plugin install hermes
evercli plugin install opencode
evercli plugin install openclaw

# 4. Verify
evercli doctor
```

Once installed, open your Agent and ask "what do you remember about me?" — it will use the MCP `mem://profile` resource to recall.

> Self-hosting EverOS? Set `EVERME_API_BASE=https://your-host` before `auth login` and the CLI will talk to your endpoint instead.

## What's Inside

| Path | Package | Purpose |
| :--- | :--- | :--- |
| [`cli/`](cli/) | `evercli` | Go CLI for auth, plugin install, importers, doctor |
| [`plugins/agent-sdk/`](plugins/agent-sdk/) | `@everme/agent-sdk` | Shared HTTP client + `evt_*`/`emk_*` redaction |
| [`plugins/memory-mcp/`](plugins/memory-mcp/) | `@everme/memory-mcp` | MCP server exposing `mem://profile` and `mem://search` |
| [`plugins/claude-code/`](plugins/claude-code/) | `@everme/claude-code` | Native Claude Code plugin (hooks · commands · skills · MCP) |
| [`plugins/openclaw/`](plugins/openclaw/) | `@everme/openclaw` | OpenClaw ContextEngine plugin |
| [`plugins/cli/`](plugins/cli/) | `@everme/cli` | npm wrapper that downloads the platform-native `evercli` binary |
| [`plugins/everme/`](plugins/everme/) | Codex marketplace plugin | Codex App / Codex CLI recall via MCP resources |

## Use It With Your Agent

Each Agent has its own configuration surface. `evercli plugin install ` writes the right file at the right path, with `0600` permissions for any credential-bearing config.

| Agent | Install command | What gets configured |
| :--- | :--- | :--- |
| **Claude Code** | `evercli plugin install claude-code` | `~/.claude/everme.env` + plugin registration |
| **Codex (App + CLI)** | `evercli plugin install codex` | `~/.codex/config.toml` MCP entry + marketplace plugin |
| **Cursor** | `evercli plugin install cursor` | Cursor MCP config |
| **Hermes** | `evercli plugin install hermes` | `/everme.env` + `~/.hermes/config.yaml` MCP entry |
| **Claude Desktop** | `evercli plugin install claude-desktop` | Claude Desktop MCP config |
| **OpenClaw** | `evercli plugin install openclaw` | OpenClaw plugin registration |

The memory each Agent reads and writes lives in **one shared memory pool** keyed to your account — so context follows *you*, not the app.

## Architecture

```
┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│  Claude Code     │    │  Codex / Cursor  │    │  Hermes / etc.   │
└────────┬─────────┘    └────────┬─────────┘    └────────┬─────────┘
         │ MCP / Hooks           │ MCP                   │ MCP
         ▼                       ▼                       ▼
   ┌───────────────────────────────────────────────────────────┐
   │  @everme/* plugins  +  evercli  (this repo)               │
   │  - mem://profile  / mem://search    (MCP resources)       │
   │  - tools: mem_save_fact, mem_save_turn, mem_context, …    │
   │  - per-agent token storage at 0600                        │
   └────────────────────────┬──────────────────────────────────┘
                            │ HTTPS + Bearer evt_*
                            ▼
   ┌───────────────────────────────────────────────────────────┐
   │  EverMe gateway  →  EverOS memory engine                  │
   │  (managed: api.everme.evermind.ai · self-host: your URL)  │
   └───────────────────────────────────────────────────────────┘
```

Memory is **global per user** (not per workspace) — multiple Agents on multiple devices share the same memory pool, with semantic search providing relevance ranking.

## Development

```bash
# CLI (Go)
cd cli
make build
make test          # go test -race ./...

# Plugin workspace (Node)
cd plugins
npm ci
npm test --workspaces --if-present
```

Release flow and packaging are documented in [`cli/README.md`](cli/README.md) and [`Makefile`](Makefile) (`make dist` builds a clean source tarball).

## Public Contracts

EverMe is read by AI Agents as much as by humans. The stable contract for CLI stdout/stderr, structured errors, MCP tools/resources, and token redaction is documented in [`docs/contracts.md`](docs/contracts.md). Changes that break those contracts are versioned.

## Security

Do not paste API keys, `emk_*` keys, `evt_*` agent tokens, cookies, or private logs into issues or pull requests. See [`SECURITY.md`](SECURITY.md) for the private reporting path (`security@evermind.ai`).

## Contributing

See [`CONTRIBUTING.md`](CONTRIBUTING.md). Bug reports, plugin support for new Agents, and additional importers are all welcome.

## License

[Apache-2.0](LICENSE). © 2026 EverMind AI.

[](#readme-top)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [EverMind-AI](https://github.com/EverMind-AI)
- **Source:** [EverMind-AI/EverMe](https://github.com/EverMind-AI/EverMe)
- **License:** Apache-2.0
- **Homepage:** https://evermind.ai/everme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-evermind-ai-everme
- Seller: https://agentstack.voostack.com/s/evermind-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.