不要再让 AI 重新发明你已经摸索过的轮子。

memarium plugin 把你过去的 Claude Code、VS Code Copilot Chat 与 Codex Desktop / 交互式 CLI 会话蒸馏成一套 agent 能直接 recall 的 分层记忆 — 每个项目背后的 episode、决定、死胡同与长期成立的事实。跑一次 /memarium 整理素材，做任何不平凡的任务前跑一次 /memarium-recall 把相关的过去工作翻出来。

Claude Code 插件独立运行 · 无外部服务 MIT

安装在 GitHub 上查看

它解决的痛点

你每一次 AI 编程会话都是一次性的。下一次会话、下一个 agent、明天早上 — 没人记得你昨天调过什么 bug。它们重新推导每一个架构决策、重新踩每一个 macOS 怪坑、重新读你已经解释过两遍的代码。

你的 Claude Code 与 Codex 会话历史已经保存在本地。 memarium 读取它们、把它蒸馏成分层记忆，让未来的会话可以站在这些素材之上。

两个 slash 命令

`/memarium`

扫描 Claude Code、Copilot Chat 与 Codex Desktop / 交互式 CLI 历史,把每个会话蒸馏成分层记忆:

episode — 一个工作线一份,正文承载整条脉络 (Context / What worked / Dead ends / Open questions / Decisions), 并带 AI 优先的元数据(files_touched、 commits、entities、 sourceSessions)。
事实 — 蒸馏出的 semantic / procedural / core 记忆、一层 实体 wiki 与一层问答, 都按 recall 评分。

根据 cwd 自动判断项目;在非项目目录里会问你要不要做全量整理。

`/memarium-recall`

开始新工作之前的两阶段 recall。专门为 AI agent 廉价消费而设计:

第一阶段 — 对分层记忆索引做一次排序查询: 最相关的 episode 加匹配的事实,每条都带一句 whyRecalled(廉价,不含正文)。
第二阶段 — 真正需要的那几条读全文。

调用代价很低,Claude 可以在每个"我们好像之前做过……"的瞬间不假思索地触发第一阶段。

recall 究竟做什么 — 一个说明性场景

Recall 不是你需要记着主动调用的功能。是 Claude 在感觉 "这事儿好像和过去的工作有重叠" 时自己伸手去翻的工具。想象你对 Claude 说:

> 这个集成测试已经 flaky 一周了,帮我修一下

你没问"我们以前遇到过吗"。你只是要一个修复。但 Claude 把"flaky 测试"识别成 recall 的触发词,先跑一次 /memarium-recall 第一阶段 — 对你的记忆做一次排序查询,几乎免费。第一阶段把一条 episode flaky-test-investigation 排在最前面。Claude 读它的正文,拿到一份结构化摘要:

上次的真实根因 — 测试假设 UTC;CI runner 时区是 America/Los_Angeles。下午 4 点到午夜之间才 fail, 看起来像随机。
当时 ship 的修复 — 把日期断言包进固定时区的 helper;commit a1b2c3d。
已经走过的死胡同 — 给共享 fixture 加 mutex(无效,不是竞态);把网络超时调到 30 秒 (无效,根本没网络);二分依赖找回归点(无效,问题早于可疑升级)。
留下的开放问题 — 同文件还有三个测试用 new Date(),迟早会踩同一个坑。

于是 Claude 直接告诉你:

据 episode flaky-test-investigation:这个 suite 在三月份也 flaky,根因是
时区假设。mutex / 超时 / 二分依赖三条路当时已经试过排除掉了。
要不要我直接套用同款固定时区修复,顺手把 episode 里标记的另外
三处可疑调用也提前修了?

最后这段才是 recall 值得自动调用的理由。如果没有它, Claude 会重新走同样的死胡同 — git log 会显示"修了 flaky 测试"的 commit,但 commit message 不会记你排除掉了什么。Episode 把两半都保留下来, recall 在 Claude 烧上下文重新探索之前就把它们摆出来。

安装

在 Claude Code 里两条命令:

/plugin marketplace add june9593/memarium-plugin
/plugin install memarium

就这样。开任何一个 Claude Code 会话,跑 /memarium 整理本机会话,或者 /memarium-recall 翻过去的笔记。不需要 npm install,不需要外部服务,数据全部留在 ~/.memarium/。

写到哪里

所有产物都在 ~/.memarium/session-repo/ 下:

raw_sessions/<tool>/<project>/<date>/*.md — 渲染过的会话副本
memory/{core,semantic,episodic,procedural}/*.md — 分层记忆(另有 entities/ 实体 wiki、qa/ 问答)
.memarium/index.json — 单个会话条目索引
.memarium/index.memory.json — 分层记忆索引(另有 index.entity.json / index.qa.json)

插件不会创建或修改 .git/ 或可选 npm CLI 的任何配置文件 — 那些是跨设备同步工具的领地,装了 npm CLI 才有。

跨设备同步(可选)

要把会话和记忆带到多台机器之间,装可选的 memarium npm CLI:

npm i -g memarium
memarium init

它把 ~/.memarium/session-repo/ 同步到一个私有的 GitHub repo。插件和 npm CLI 在同一个 spool 路径上协作,条目用 sessionId 做 key — 装其中一个、两个都装、或者都不装, 按你需要选。

memarium npm CLI →

项目链接

MIT 许可证 · 完整的 Vitest 测试套件覆盖 autonomy、scan、 orchestrator、digest 与记忆 · 自包含的 esbuild bundle,运行时不需要 npm install。