内容
# agmry
[](https://www.npmjs.com/package/agmry)
[](https://agenticmemory.ai/quickstart)
[](#远程-mcp--零安装)
[](https://smithery.ai/servers/jyswee/agenticmemory)
**AI 代理的持久内存** — 会话历史、键值上下文和跨会话的语义搜索。就像 git 一样简单。
> **git 记得你的代码。agmry 记得其他一切。**
你的代理每天都写出优秀的代码，但在上下文窗口重置时却忘记了所有的决定。你成为了内存层：重新解释项目、偏好和上次出错的内容。Agentic Memory 是你的代理自己运行的内存：一次安装，它存储、回忆和搜索自己的状态，跨越会话、机器甚至其他代理。它甚至可以**自己注册** — 一个命令返回一个可用的 API 密钥，无需浏览器，无需人工。
**适用于：** Claude Code · Cursor · Cline · Windsurf · Aider · Codex · 任何 MCP 客户端
[](https://agenticmemory.ai/#demo)
*60 秒内安装并完全回忆 — 真实的终端会话，无需模拟。 [观看所有演示](https://agenticmemory.ai/#demo)。*
## 安装
```bash
npm install -g agmry
```
## 快速开始
```bash
# 代理自行注册 — 立即返回有效密钥，无需卡片，无需浏览器
agmry signup my-project --local
# 存储内存
agmry store my-project "用户偏好 TypeScript 严格模式和 pnpm"
# 新会话？回忆一切
agmry recall my-project
# 半记得某事？搜索它
agmry search my-project "如何部署"
# 完整参考
agmry --help
```
## 代理自行注册
无需浏览器。无需 OAuth。无需等待人工。
```
$ agmry signup my-project
✓ 项目 "my-project" 已创建
API 密钥：amk_************************ （保存到 .agmry/config.json）
生效中： 48 小时完全访问权限 — 今日无需卡片，$0
```
密钥立即生效 — 每个端点，每个工具，48 小时内完全访问权限。在此窗口内，您的人类完成 $0 卡片认证，开始 **免费 7 天试用**，使用相同的密钥。如果错过窗口？不会删除任何内容 — 密钥暂停，当卡片认证完成时恢复。添加 `--email you@company.com`，人类自动获取链接。
## 三种内存层级 — 因为并非所有内存都相等
转录数据并不是内存。代理需要不同的回忆来处理不同的事情：
```bash
# 短期：有序、角色感知的会话历史（亚毫秒级读取）
agmry store my-project "部署了 v2.1，回滚 — 迁移锁定了用户表" -r assistant
agmry recall my-project -n 50
# 持久事实：键值上下文 — 决策、偏好、运行手册
agmry ctx my-project set deploy_flow "推送镜像到注册表，然后询问基础设施滚动"
agmry ctx my-project get deploy_flow
# 长期：有标题、有标签的知识条目，存活数月
agmry entry my-project "身份验证决策" "JWT 而非会话 — 移动客户端无法持有 Cookie" --tags "arch,decisions"
agmry entries my-project --tags "decisions"
# 进行中：允许过期的临时工作区
agmry scratch my-project set "进行到一半的计费重构，invoice.js 接下来"
```
语义搜索将它们联系起来，当代理只记得一半时：
```bash
agmry search my-project "我们是否讨论过速率限制"
# → 弹出一个月前的条目，附带相似度评分
```
## 会话启动 = 一条命令
不再需要将昨天的总结粘贴到今天的提示中：
```bash
agmry boot my-project --json # 消息 + 上下文 + 条目，一次调用
agmry boot my-project --semantic "计费重构" # 或聚焦于某个主题
```
~200 个结构化状态令牌，而不是旧转录的 top-k 分片。
## MCP 服务器
更喜欢使用 CLI 以外的工具？`agmry` 配备了 MCP 服务器。将 Claude Code（或任何 MCP 客户端）指向它，您的代理获得 **17 个原生工具**：存储、回忆、搜索、引导、上下文、条目、空间、队列。
```bash
claude mcp add agenticmemory -- agmry mcp-serve
```
[](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-mcp.mp4)
*Claude Code 通过 MCP 跨会话记住 — 点击观看。*
对于使用 JSON 配置的客户端（Cline、Cursor、Windsurf），通过环境传递您的 API 密钥 — MCP 服务器在您的项目目录之外运行，因此它不会获取 `.agmry/config.json`:
```json
{
"mcpServers": {
"agenticmemory": {
"command": "agmry",
"args": ["mcp-serve"],
"env": { "AGMRY_API_KEY": "amk_your_key_here" }
}
}
}
```
### 远程 MCP — 零安装
Claude Web、Claude Desktop、Raycast 或任何托管的 MCP 客户端可以直接连接到远程服务器。相同的工具，相同的 API 密钥，无需安装任何东西：
```
URL： https://mcp.agenticmemory.ai/sse
认证： Authorization: Bearer YOUR_API_KEY
```
## 端到端加密（零知识空间）
创建一个服务器永远无法读取的空间。加密发生在 CLI 内部 —
API 只会看到密文。
```bash
agmry key generate # 一次性：创建 + 保存您的密钥
agmry space create "Private" private --encryption e2e
agmry store SPACE "我的秘密" # 加密后离开您的机器
agmry recall SPACE # 透明解密
agmry key verify SPACE # 持有正确的密钥？
```
或者，从密码短语中派生每个空间的密钥：
```bash
agmry key set --passphrase "长秘密短语"
```
注意：
- 语义搜索在零知识空间中无法实现，设计如此。
- 更喜欢 **静态加密**？ `--encryption managed` — 服务器在静态加密您的数据，并且所有功能（搜索、摘要）继续工作。无需客户端密钥。
- 丢失密钥或密码短语意味着数据无法恢复。这就是目的。备份它：`agmry key show --reveal`.
密钥解析顺序： `--enc-key` / `--passphrase` 标志 → `AGMRY_ENCRYPTION_KEY` 环境变量 → `./.agmry/config.json` → `~/.agmry/config.json`。与 Node 和 Python SDK 相同的信封和密钥派生 — 密钥在所有三个平台上可互换。
## 多代理：一个大脑，许多代理
空间可共享。一个代理存储部署运行手册，另一个代理一周后从不同机器、不同接口（CLI、MCP 或 REST — 相同的内存）中回忆它。您的代理在会话之间和项目之间传递上下文，无需您传递。
而且，您仍然在循环中：您的代理记住的一切都在人类仪表板中可见。
[](https://prodmedia.tyga.host/public/tyga.cloud/landing/agenticmemory.ai/demo/agmry-dashboard.mp4)
*您的代理记住的一切，都在一个仪表板中 — 点击观看。*
## 队列 — 代理总线
空间内的 FIFO 队列。一个代理推送工作，另一个代理弹出它 — 无需轮询胶水，无需额外基础设施。
```bash
agmry queue SPACE jobs push '{"task":"review PR #42"}' # 入队（FIFO）
agmry queue SPACE jobs pop # 出队最旧的 — 如果为空，退出代码为 2
agmry queue SPACE jobs pop --wait 25 # 最多等待 25 秒获取下一个项目
agmry queue SPACE jobs # 窥视：长度 + 头部，不消耗
agmry queue SPACE jobs dlq push '{"task":"..."}' --reason "failed twice" # 死信队列
agmry queue SPACE jobs dlq list # 检查死信队列中的项目
```
空时退出代码为 2，shell 循环分支清晰：`while agmry queue SPACE jobs pop --wait 25 --json; do ...; done`。信封是不透明的 JSON — 服务器从不检查它们。
## 代理集成
添加到您的 CLAUDE.md、.cursorrules、.clinerules、.windsurfrules 或 AGENTS.md：
```
## Agentic Memory
此项目使用 Agentic Memory 进行跨会话的持久内存。
使用 `agmry` CLI。密钥位于 .agmry/config.json（自动加载）。
agmry boot SPACE --json # 会话开始时加载所有内容
agmry store SPACE "发生了什么" # 记住某些事情
agmry ctx SPACE set key "value" # 存储持久的决策/事实
agmry search SPACE "截止日期" # 查找过去的上下文
agmry queue SPACE jobs push '{...}' # 向另一个代理发送工作
agmry queue SPACE jobs pop --wait 25 # 接收工作（退出 2 = 空）
```
## 配置优先级
1. `--key` 标志
2. `AGMRY_API_KEY` 环境变量
3. `AGENTICMEMORY_API_KEY` 环境变量
4. `./.agmry/config.json`（项目本地）
5. `~/.agmry/config.json`（全局）
将 `.agmry/` 添加到您的 `.gitignore` 中。
## 功能
- **会话历史** — 有序、角色感知的消息，带有近期窗口，亚毫秒级读取
- **键值上下文** — 类型化的持久事实：决策、偏好、运行手册
- **长期条目** — 有标题、有标签的知识，存活数月，自动总结
- **实体** — 代理应该了解的人员和系统
- **临时工作区** — 带有 TTL 的临时工作内存（过期是功能）
- **语义搜索** — 跨代理存储的所有内容
- **引导** — 一次调用中获取完整会话上下文
- **代理自行注册** — 一条 CLI 命令返回有效的 API 密钥，生效 48 小时，无需卡片；$0 卡片认证开始免费 7 天试用
- **队列** — FIFO 代理总线，带有长轮询和死信队列，`agmry queue`（退出 2 = 空）
- **MCP 服务器** — 17 个工具，本地（`agmry mcp-serve`）或完全远程（`mcp.agenticmemory.ai`）
- **REST API** — 代理和管道请求路径上的相同内存
- **多代理空间** — 一个内存由多个代理读取和写入
- **端到端加密** — 零知识空间，只有您持有密钥（`agmry key generate`）
- **导出** — 每个空间的完整数据导出，一条命令（`agmry space export`）
**定价：** 代理密钥立即生效 — 48 小时内完全访问，无需卡片。$0 卡片认证开始免费 7 天试用；之后 $24.99/月。不会删除任何数据：您的内存等待您。 [详情](https://agenticmemory.ai/pricing)。
## 为什么不使用 Claude 内置内存？
Claude Memory 很棒 — 但它只适用于 Claude，而且只有 Claude 才能决定其中包含什么。
| | Agentic Memory | Claude Memory |
|---|---|---|
| **LLM 支持** | 任意 — GPT、Claude、Gemini、Llama、Mistral、DeepSeek | 仅限 Claude |
| **切换 LLM** | 保留所有内存 | 丢失所有内容 |
| **多代理** | 代理间共享空间 | 单用户 |
| **编程控制** | 完整的 CLI + MCP + REST | 黑盒 — Claude 决定 |
| **结构化数据** | 消息 + 上下文 + 条目 + 实体 + 临时工作区 | 自由文本笔记 |
| **语义搜索** | `agmry search "截止日期"` | 无搜索 API |
| **数据所有权** | 您拥有它，随时导出 | 由 Anthropic 存储 |
## 为什么存在此功能
我曾经是我的代理的内存。每个会话都以我重新向自己的工具解释自己的项目 — 决策、偏好、上次出错的内容开始。所以我为它们构建了它们自己运行的内存。我的代理在十几个项目中使用它；如果有问题或遗漏，[开启一个问题](https://github.com/jyswee/agenticmemory/issues) — 我会阅读每一个。
## 文档
- [快速入门指南](https://agenticmemory.ai/quickstart) — Claude Code、Cursor、LangChain、CrewAI、AutoGen + 7 更多
- [API 文档](https://agenticmemory.ai/docs)
- [定价](https://agenticmemory.ai/pricing)
## 许可证
专有 — Tyga.Cloud Ltd. 查看 [LICENSE](./LICENSE)。
