EverMe 是真正懂你的数字分身，从一份真正属于你的记忆开始。每一次对话沉淀为经验、每一段经验固化为能力 —— Agent 的进化闭环。
本仓库提供把任意 AI Agent —— Claude Code、Cursor、Codex、Hermes、OpenClaw 等 —— 接入 EverMe 记忆层所需的客户端工具链。托管服务与 EverOS 记忆引擎分别独立：
| 层级 | 提供什么 | 在哪里 |
|---|---|---|
| EverMe CLI + 插件（本仓库） | 登录认证、插件安装、MCP server、Agent hooks | EverMind-AI/EverMe（Apache-2.0） |
| EverOS 记忆引擎 | 长期记忆操作系统 | EverMind-AI/EverOS（已开源） |
| EverMe 托管服务 | 后端、账号、计费 | evermind.ai/everme |
可以选择直接对接托管服务，也可以自托管 EverOS 引擎 —— 通过 EVERME_API_BASE 把 CLI 指向你自己的部署即可。
把下面这句话粘贴给任意一个你本地已经在用的 AI Agent（Claude Code、Cursor、Codex、……）：
Read https://everme.evermind.ai/SKILL.md and follow the instruction to install and configure EverMe.
Agent 会自动拉取 skill、安装 CLI、引导你登录、并为自己注册插件 —— 无需任何手工步骤。
# 1. 安装 CLI
npm install -g @everme/cli
# 2. 登录（浏览器走 Device Flow）
evercli auth login
# 3. 接入 Agent —— 装一个或多个：
evercli plugin install claude-code
evercli plugin install codex
evercli plugin install cursor
evercli plugin install hermes
evercli plugin install openclaw
# 4. 自检
evercli doctor装好后打开你的 Agent，问它 "what do you remember about me?" —— 它会通过 MCP mem://profile 资源去召回你的记忆。
自托管 EverOS？在
auth login之前设置EVERME_API_BASE=https://your-host，CLI 就会去访问你自己的端点。
| 路径 | 包名 | 作用 |
|---|---|---|
cli/ |
evercli |
Go 写的 CLI，负责登录、插件安装、记忆导入、诊断 |
plugins/agent-sdk/ |
@everme/agent-sdk |
共享 HTTP 客户端 + evt_*/emk_* token 脱敏 |
plugins/memory-mcp/ |
@everme/memory-mcp |
暴露 mem://profile 与 mem://search 的 MCP server |
plugins/claude-code/ |
@everme/claude-code |
Claude Code 原生插件（hooks · commands · skills · MCP） |
plugins/openclaw/ |
@everme/openclaw |
OpenClaw ContextEngine 插件 |
plugins/cli/ |
@everme/cli |
自动下载 evercli 平台二进制的 npm 封装 |
plugins/everme/ |
Codex marketplace 插件 | 通过 MCP resources 给 Codex App / Codex CLI 提供召回 |
每个 Agent 的配置入口不同。evercli plugin install <agent> 会把对应文件写入对应路径，所有承载凭据的配置都强制 0600 权限。
| Agent | 安装命令 | 写入的配置 |
|---|---|---|
| Claude Code | evercli plugin install claude-code |
~/.claude/everme.env + 插件注册 |
| Codex（App + CLI） | evercli plugin install codex |
~/.codex/config.toml MCP 条目 + marketplace 插件 |
| Cursor | evercli plugin install cursor |
Cursor MCP 配置 |
| Hermes | evercli plugin install hermes |
<hermes_home>/everme.env + ~/.hermes/config.yaml MCP 条目 |
| Claude Desktop | evercli plugin install claude-desktop |
Claude Desktop MCP 配置 |
| OpenClaw | evercli plugin install openclaw |
OpenClaw 插件注册 |
所有 Agent 读写的记忆都落在同一份记忆池里，按你的账号隔离 —— 所以上下文跟着你走，而不是被锁在某个 App 里。
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ Claude Code │ │ Codex / Cursor │ │ Hermes / etc. │
└────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘
│ MCP / Hooks │ MCP │ MCP
▼ ▼ ▼
┌───────────────────────────────────────────────────────────┐
│ @everme/* plugins + evercli （本仓库） │
│ - mem://profile / mem://search (MCP resources) │
│ - tools: mem_save_fact, mem_save_turn, mem_context, … │
│ - 凭据按 0600 落盘 │
└────────────────────────┬──────────────────────────────────┘
│ HTTPS + Bearer evt_*
▼
┌───────────────────────────────────────────────────────────┐
│ EverMe 网关 → EverOS 记忆引擎 │
│ (托管：api.everme.evermind.ai · 自托管：你的 URL) │
└───────────────────────────────────────────────────────────┘
记忆是按用户全局的（不按 workspace / 项目隔离）—— 同一个账号的多个 Agent、多台设备共读同一份记忆池，由语义搜索负责相关性排序。
# CLI（Go）
cd cli
make build
make test # go test -race ./...
# 插件 workspace（Node）
cd plugins
npm ci
npm test --workspaces --if-present发布流程与打包规则见 cli/README.md 和 Makefile（make dist 生成干净的源码 tarball）。
EverMe 同时被人和 AI Agent 读取。CLI 的 stdout/stderr、结构化错误、MCP tools/resources、token 脱敏规则的稳定契约见 docs/contracts.md。任何 break 这些契约的改动都按版本管理。
不要在 issue 或 PR 中粘贴 API key、emk_*、evt_*、cookie 或私有日志。安全问题请按 SECURITY.md 提供的方式上报（security@evermind.ai）。
见 CONTRIBUTING.md。欢迎 bug 反馈、新增 Agent 的插件支持、以及更多记忆导入器的实现。
Apache-2.0. © 2026 EverMind AI.
