AgenticMemory

agmry

为 AI Agent 提供持久记忆——跨会话保存对话历史、键值上下文并进行语义搜索。像 git 一样简单。

git 记住你的代码。agmry 记住其他一切。

你的 Agent 一整天都能写出出色的代码——但上下文窗口一重置，它就会忘掉每一个决定。于是，记忆层就变成了你：不断重讲项目、偏好，以及上次出了什么问题。Agentic Memory 是 Agent 自己运行的记忆：只需安装一次，它就能跨会话、跨机器，甚至跨其他 Agent 存储、回忆和搜索自身状态。它甚至可以自行注册——一条命令就能返回可用的 API 密钥，无需浏览器，也无需人工操作。

适用于： Claude Code · Cursor · Cline · Windsurf · Aider · Codex · 任意 MCP 客户端

60 秒内从安装到完整回忆——真实终端会话，不是效果图。观看所有演示。

安装

npm install -g agmry

快速开始

# Agent signs itself up — working key returned instantly, no card, no browser
agmry signup my-project --local

# Store memory
agmry store my-project "User prefers TypeScript strict mode and pnpm"

# New session? Recall everything
agmry recall my-project

# Half-remember something? Search it
agmry search my-project "how do we deploy"

# Full reference
agmry --help

Agent 自行注册

无需浏览器。无需 OAuth。无需等待人工操作。

$ agmry signup my-project
✓ Project "my-project" created
  API key: amk_************************  (saved to .agmry/config.json)
  Live:    full access for 48h — no card, $0 today

密钥立即生效——所有端点、所有工具，均可在 48 小时内完整访问。在此期间，你的人工用户完成一项 $0 的银行卡验证，即可用同一个密钥开启7 天免费试用。错过了时限？不会删除任何内容——密钥会暂停，并在银行卡验证完成后立即恢复。添加 --email [email protected]，人工用户就会自动收到链接。

三层记忆——因为并非所有记忆都一样

转录内容的堆积并不等于记忆。不同内容需要不同的回忆方式：

# Short-term: ordered, role-aware conversation history (sub-ms reads)
agmry store my-project "Deployed v2.1, rolled back — migration locked the users table" -r assistant
agmry recall my-project -n 50

# Durable facts: typed key-value context — decisions, preferences, runbooks
agmry ctx my-project set deploy_flow "push image to registry, then ask infra to roll"
agmry ctx my-project get deploy_flow

# Long-term: titled, tagged knowledge entries that survive months
agmry entry my-project "Auth decision" "JWT not sessions — mobile clients can't hold cookies" --tags "arch,decisions"
agmry entries my-project --tags "decisions"

# Work-in-progress: scratchpad that's allowed to expire
agmry scratch my-project set "midway through the billing refactor, invoice.js next"

当 Agent 只记得一部分时，语义搜索还会将这些内容串联起来：

agmry search my-project "did we ever discuss rate limiting"
# → surfaces a months-old entry, with similarity score

会话开始 = 一条命令

无需把昨天的摘要粘贴到今天的提示词中：

agmry boot my-project --json          # messages + context + entries, one call
agmry boot my-project --semantic "billing refactor"   # or focused on a topic

约 200 个 token 的结构化状态，而不是旧转录中排名靠前的片段。

MCP 服务

更喜欢使用工具而不是 CLI？agmry 内置了 MCP 服务。将 Claude Code（或任意 MCP 客户端）连接到它，你的 Agent 就能使用 17 个原生工具：存储、回忆、搜索、引导初始化、上下文、条目、空间、队列。

claude mcp add agenticmemory -- agmry mcp-serve

Claude Code 通过 MCP 跨会话记忆——点击观看。

对于使用 JSON 配置的客户端（Cline、Cursor、Windsurf），请通过环境变量传递 API 密钥——MCP 服务在项目目录之外运行，因此不会读取 .agmry/config.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
Auth: Authorization: Bearer YOUR_API_KEY

端到端加密（零知识空间）

创建一个服务器永远无法读取的空间。加密在 CLI 内部完成—— API 只能看到密文。

agmry key generate                                  # one-time: creates + saves your key
agmry space create "Private" private --encryption e2e

agmry store SPACE "my secret"                       # encrypted before it leaves your machine
agmry recall SPACE                                  # transparently decrypted
agmry key verify SPACE                              # holding the right key?

也可以使用密码短语派生每个空间的密钥，而不是存储密钥：

agmry key set --passphrase "long secret phrase"

注意：

• 零知识空间无法进行语义搜索，这是设计使然。
• 更倾向于静态加密？使用 --encryption managed——服务器会对静态数据进行加密，且所有功能（搜索、摘要）都能正常使用。无需客户端密钥。
• 丢失密钥或密码短语意味着数据无法恢复。这正是设计目的。请做好备份：agmry key show --reveal。

密钥解析顺序：--enc-key / --passphrase 标志 → AGMRY_ENCRYPTION_KEY 环境变量 → ./.agmry/config.json → ~/.agmry/config.json。与 Node 和 Python SDK 使用相同的信封和密钥派生方式——三者之间的密钥可以互换。

多 Agent：一个大脑，多个 Agent

空间可以共享。一个 Agent 存储部署操作手册；另一个 Agent 一周后从另一台机器、通过另一种接口（CLI、MCP 或 REST——使用同一份记忆）取回它。你的 Agent 可以在不同会话和项目之间交接工作，无需你手动传递上下文。

而且你始终参与其中：Agent 记住的所有内容都可以在人工管理面板中浏览。

Agent 记住的所有内容都在一个管理面板中 — 点击观看。

队列 — Agent 总线

空间内的 FIFO 队列。一个 Agent 推送工作，另一个 Agent 取出——无需轮询逻辑，也无需额外基础设施。

agmry queue SPACE jobs push '{"task":"review PR #42"}'   # enqueue (FIFO)
agmry queue SPACE jobs pop                                # dequeue oldest — exit code 2 if empty
agmry queue SPACE jobs pop --wait 25                      # long-poll up to 25s for the next item
agmry queue SPACE jobs                                    # peek: length + head, without consuming
agmry queue SPACE jobs dlq push '{"task":"..."}' --reason "failed twice"   # dead-letter
agmry queue SPACE jobs dlq list                           # inspect dead-lettered items

队列为空时返回退出代码 2，便于 shell 循环进行分支处理：while agmry queue SPACE jobs pop --wait 25 --json; do ...; done。信封是不可解读的 JSON——服务器不会检查其内容。

Agent 集成

添加到你的 CLAUDE.md、.cursorrules、.clinerules、.windsurfrules 或 AGENTS.md 中：

## Agentic Memory
This project uses Agentic Memory for persistent memory across sessions.
Use the `agmry` CLI. Key is in .agmry/config.json (auto-loaded).

agmry boot SPACE --json               # load everything at session start
agmry store SPACE "what happened"     # remember something
agmry ctx SPACE set key "value"       # store a durable decision/fact
agmry search SPACE "the deadline"     # find past context
agmry queue SPACE jobs push '{...}'   # send work to another agent
agmry queue SPACE jobs pop --wait 25  # receive work (exit 2 = empty)

配置优先级

1. --key 标志
2. AGMRY_API_KEY 环境变量
3. AGENTICMEMORY_API_KEY 环境变量
4. ./.agmry/config.json（项目本地）
5. ~/.agmry/config.json（全局）

将 .agmry/ 添加到你的 .gitignore。

功能

• 对话历史 — 有序、感知角色的消息，支持近期窗口筛选，读取耗时低于毫秒
• 键值上下文 — 类型化的持久事实：决策、偏好、操作手册
• 长期条目 — 带标题和标签的知识，可保存数月，并自动生成摘要
• 实体 — Agent 应当了解的人物和系统
• 暂存区 — 带 TTL 的临时工作记忆（过期也是一项功能）
• 语义搜索 — 搜索 Agent 曾存储的所有内容
• 引导加载 — 一次调用即可获取完整会话上下文
• Agent 自助注册 — 通过一条 CLI 命令获取可用的 API 密钥，免密使用 48 小时；通过 $0 卡验证即可开始免费 7 天试用
• 队列 — 支持长轮询和死信机制的 FIFO Agent 总线，agmry queue（退出代码 2 = 队列为空）
• MCP 服务 — 46 个工具，可在本地运行（agmry mcp-serve）或完全远程运行（mcp.agenticmemory.ai）
• REST API — 在代理和流水线的请求路径上使用同一份记忆
• 多 Agent 空间 — 一组 Agent 读写同一份记忆
• 端到端加密 — 只有你持有密钥的零知识空间（agmry key generate）
• 导出 — 一条命令即可导出每个空间的全部数据（agmry space export）

**定价：**Agent 的密钥可立即使用——无需银行卡即可获得 48 小时完整访问权限。通过 $0 卡验证即可开始免费 7 天试用；之后价格从每月 $24.99 起。数据永不删除：你的记忆会一直为你保留。详情。

为什么不直接使用 Claude 内置的记忆？

Claude Memory 很棒，但它只能与 Claude 搭配使用，而且只有 Claude 才能决定其中存放什么。

	Agentic Memory	Claude Memory
大模型支持	任意模型 — GPT、Claude、Gemini、Llama、Mistral、DeepSeek	仅 Claude
切换大模型	保留所有记忆	全部丢失
多 Agent	在多个 Agent 之间共享空间	单个用户
程序化控制	完整的 CLI + MCP + REST	黑箱 — 由 Claude 决定
结构化数据	消息 + 上下文 + 条目 + 实体 + 暂存区	自由文本笔记
语义搜索	agmry search "the deadline"	无搜索 API
数据所有权	数据归你所有，可随时导出	由 Anthropic 存储

为什么要开发它

我成了我的 Agent 的记忆。每次会话开始时，我都得向自己的工具重新解释自己的项目——包括决策、偏好，以及上次出了什么问题。于是我构建了一个让它们自行运行的记忆系统。我的 Agent 已在十多个项目的生产环境中使用它；如果有不完善或缺失之处，请提交问题——我会逐一阅读。

文档

• 快速入门指南 — Claude Code、Cursor、LangChain、CrewAI、AutoGen 等另外 7 个框架
• API 文档
• 定价

许可证

专有软件 — Tyga.Cloud Ltd. 请参阅 LICENSE。