agent-memory API 速查手册23 个 mem CLI 子命令与 9 个 MCP 工具完整参考【免费下载链接】agent-memoryLong-term memory runtime for AI agents — plain Markdown as the source of truth, local ranked retrieval, and an independent sleep-time Manage layer. Claude Code and Codex share one store. No API key.项目地址: https://gitcode.com/gh_mirrors/age/agent-memoryagent-memory 是面向 AI Agent 的本地长期记忆运行时以纯 Markdown 文件为唯一事实来源配合本地 BM25 排序检索与独立的 sleep-time Manage 管理层让 Claude Code、Codex CLI、Muse Code 共享同一个记忆库且无需任何 API Key。本文是一份速查手册完整覆盖memCLI 的全部 23 个子命令与 9 个 MCP 工具的参数、用途和常用组合方便你随时查阅。一图看懂两条接入路径 agent-memory 提供两条入口最终都收敛到同一套核心调用同一请求经任何入口得到相同结果memCLI任何能执行 shell 命令的宿主都能用是功能最全的入口mem-mcpMCP 工具说 MCP 协议的 Agent 通过 9 个memory_*工具调用核心能力CLI 定义位于 packages/cli/src/agent_memory/cli/main.pyMCP 工具定义位于 packages/mcp/src/agent_memory/mcp/tools.py。mem CLI 全局参数每条mem命令都支持三个全局参数可放在子命令之前参数说明--store 路径指定记忆库根目录默认读取环境变量AGENT_MEMORY_STORE缺省~/agent-memory-store--agent 标识调用方身份默认cli--json输出机器可读的 JSON退出码约定0成功、1存储错误、2参数/校验错误见 main.py。mem CLI 全部 23 个子命令速查1️⃣ 建库与体检命令作用关键参数mem init创建记忆库目录结构—mem inspect库健康检查active/总数/无效数、悬空链接、索引指纹—mem rebuild丢弃并重建索引删库重建零知识丢失—mem migrate将旧版四域布局升级到 schema 布局—2️⃣ 写入类记录记忆命令作用关键参数mem record写入一条记忆--abstract--type必填、--field KEYVALUE可重复、--body/--body-file-表示 stdin、--name、--create-group、--link可重复、--provenance可重复、--valid-from 日期、--supersedes 旧名、--batch FILE\|-每行一个 JSON 对象批量写入mem correct原地修订或整体替换一条记忆--abstract、--body/--body-file、--supersede-with、--link整体替换链接列表可重复或--clear-links清空链接、--provenancemem supersede用已存在的活跃记忆取代旧记忆位置参数old newmem merge原子合并多条记忆并结束来源区间位置参数names...、--abstract--body必填、--namemem delete结束一条记忆的有效期保留历史位置参数namemem feedback显式加权或减权位置参数name、--boost/--penalize二选一3️⃣ 读取类检索与逐层深入命令作用关键参数mem recall query返回 L0 候选清单摘要路径锚点分数默认 8 条--scope、--as-of 日期按时间点回溯、--limitmem context query一次调用完成检索 展开 Top 条目最省事的入口同recallmem read name按层级读取一条记忆--level abstract\|outline\|full默认fullmem trace name打开该记忆引用的原始消息溯源核查--pointer sessions/id#start-end可截取子区间读取成本阶梯索引行 → abstract → outline → 全文 → 原始消息每一级都比上一级贵一个数量级按需停下即可。4️⃣ sleep-time 管理Manage 层命令作用关键参数mem sleep执行一次睡眠整理T0 直接应用T1 生成提案--sessions-since N、--reason host\|endpoint\|none、--reason-host、--reason-modelmem proposals列出等待你确认的提案—mem decide id确认或否决一个提案--accept/--reject必填二选一、--text、--abstract--body合并类提案、--parts JSON文件拆分类提案mem gc物理删除失效文件——唯一真正的删除入口需人工执行—5️⃣ 蒸馏、迁移与宿主集成命令作用关键参数mem distill把归档的会话积压交给执行器蒸馏为记忆--session可重复指定即刻蒸馏的会话、--force忽略阈值全量蒸馏、--reason host\|endpointmem export导出整个记忆库--out 文件、--no-archive不含归档mem import source把导出包导入当前库位置参数sourcemem setup安装宿主生命周期钩子 skill--host claude-code\|codex\|muse-codemuse是别名、--settings省略--host时自动探测mem skill打印 agent-memory 的 skill 文本—常用组合三条命令跑通全流程 mem init mem record --type decision --field projectagent-memory \ --abstract Markdown files are the single source of truth \ --body Indexes are rebuildable caches. mem --json recall source of truth mem sleep --reason host mem proposals mem decide id --accept9 个 MCP 工具完整参考 mem-mcp以 stdio 方式提供 JSON-RPC 服务协议版本2025-06-18工具清单与参数校验逻辑见 tools.py#工具一句话说明必填参数可选参数1memory_recall检索记忆库返回 L0 候选清单queryscope、as_of、limit2memory_read按层级读取一条记忆namelevelabstract/outline/full3memory_record写入一条记忆abstract、typefields、body、name、create_group、links、provenance、supersedes4memory_correct原地更新或用新内容取代nameabstract、body、supersede_with、links空数组[] 清空全部链接、provenance5memory_supersede让旧记忆让位给已存在的活跃记忆old、new—6memory_delete结束有效期并保留历史证据name—7memory_trace只读取该记忆引用的归档消息namepointer8memory_merge原子合并多条记忆并保留历史names、abstract、bodyname9memory_feedback显式上调/下调权重name、directionboost/penalize—注意MCP 入口比 CLI 窄。context、sleep、distill、proposals、decide、gc、export/import、setup等只有 CLI 提供——CLI 永远是通用兜底。CLI 与 MCP 的对应关系两者是同一核心调用的不同方言recall↔memory_recall、read↔memory_read、record↔memory_record、correct↔memory_correct、supersede↔memory_supersede、delete↔memory_delete、trace↔memory_trace、merge↔memory_merge、feedback --boost/--penalize↔memory_feedbackdirection参数。唯一的习惯差异CLI 用重复的--link表达链接列表MCP 直接传数组。常见问题速答 ❓Q索引坏了怎么办rm -rf $AGENT_MEMORY_STORE/.index mem rebuild——索引是完全可重建的缓存Markdown 文件才是事实来源。Q想改一条记忆用correct还是record旧内容错了→ 同名correct原地修订值发生了变化计数、目标、状态→ 新record ... --supersedes 旧名旧值保留为历史recall --as-of还能按日期回溯。QMCP 怎么接入 Muse Code把mem-mcp以 stdio 方式合并进$XDG_CONFIG_HOME/muse/settings.json的mcp_servers设置文件结构见 README新开会话后用/mcp验证 9 个工具是否出现。Q宿主的钩子装好了吗mem setup --host claude-code或codex/muse-codeSessionStart 注入索引Stop/SessionEnd 触发蒸馏PreCompact 驱逐上下文。宿主适配细节见 packages/adapters/src/agent_memory/adapters/setup.py。延伸阅读Agent 行为规范何时召回、何时写入、链接维护skills/agent-memory/SKILL.md架构与设计边界docs/design/index.md项目总览与实测数据README.mdoutput 文章【免费下载链接】agent-memoryLong-term memory runtime for AI agents — plain Markdown as the source of truth, local ranked retrieval, and an independent sleep-time Manage layer. Claude Code and Codex share one store. No API key.项目地址: https://gitcode.com/gh_mirrors/age/agent-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考