EverMe

EverMe

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

Product · Website · EverOS engine · Documentation · [中文](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 (open source) | | EverMe managed service | Hosted backend, account, billing | 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, …):

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

# 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

# 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
• Source: EverMind-AI/EverMe
• License: Apache-2.0
• Homepage: https://evermind.ai/everme

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