ai-memory

why

Agent 如果有记忆，可以快速想起上次没干完的任务、任务关联的关键代码位置、历史执行中遇到的坑、用户偏好等信息，更加找到要修改的位置、按照期望的执行。

但是记忆也会有一些问题：

1. 会话中的临时想法，被当成了偏好
2. 记忆过期，与实际代码有偏差
3. 记忆难以共享，同代码仓跨 worktree 就难以共享
4. 记忆的创建、更新、后台维护消耗 token 非常多

但是 ai-memory 的记忆维护不需要使用 token，而且是固定 md + 自动生成数据库方案，实现可随意查看修改，又能快速检索使用，且支持很多不同的 Agent 共享记忆。

how

以在 pi agent 中使用为例：

1. 安装 ai-memory，并添加到 PATH 环境变量，使得程序全局可方案
2. 初始化 ai-memory setup --yes --agent pi，会添加 pi 插件和 pi MCP
3. 随 pi 启动自动运行，会话启动自动拿到 handoff，会话中自动记忆、自动检索，会话结束，后台 ai-memory 服务可添加 LLM 整合（生成 wiki 页，更新 handoff 快照等）
4. 检查服务状态：pi 中 /mcp 中连接正常，终端 ai-memory status 正常
5. 记忆共享，给其他 agent 也接入 ai-memory run claude，自动安装 hooks + MCP