让 AI agent 用上你的记忆

在用 AI agent,想让它自动伸手够到你的工作上下文——不用你粘邮件,也不用你叮嘱一句”去 OMem 查一下”?看这一页。这才是最值的回报:agent 自己就从你真实的历史里把答案给出来。

它长什么样

接上之后,agent 一认出这是个带工作味的问题,就去查 OMem,只读它要的那点,然后作答——引用的是你真实的邮件、文档和笔记。一步步走一遍真实的来回:

你

Acme 第三季度评审里我们答应要再过一遍的待办项有哪些？

一个关于你真实工作的问题——这种问题 agent 平时是没有上下文可答的。

第 1 / 6 轮

关键在于:你不用开口叫它去用 OMem。是它自己察觉到问题沾着你的工作,主动伸的手。

一条命令,把 skill 装进每一个 agent

OMem 只有一个 skill——一层薄薄的壳,教 agent 什么时候去查你的工作记忆、怎么顺着结果往下读。装它最省事的办法,是用跨 agent 的 skills 命令行工具,一条命令就把这个 skill 铺进你机器上的每一个 AI agent:

npx skills add seacen/omem --global

它会自动认出你装了哪些 agent(Claude Code、Codex、Cursor、Cline、Windsurf……),挨个把 OMem 的 skill 装进各自的 skills 目录——不用再一个个走 plugin 流程。--global 是装到用户级、全局可用(OMem 不绑定某个项目,这才是对的);去掉它就只装进当前项目。装之前先确认 omem CLI 已经装好、也配好了(安装 → setup)。

想验证装好没?随便问一个接上的 agent 一句*“帮我看看 OMem 健康状况”*——它应该会去跑 omem doctor。

这是推荐路径。这页剩下的部分讲几条备选:按 agent 单独走 plugin(要是你不想用 skills 这个工具)、给没有 skill 机制的 agent 用的 MCP、以及纯 CLI。

其它接法

只在上面那条一行命令对你的 agent 不合用时,才挑下面的。

要是你更想走每个 agent 自己的 plugin 体系、而不用 skills 这个工具,也行。skill 是同一个,只是换了道前门。在 Claude Code 里:

/plugin marketplace add seacen/omem
/plugin install omem@omem-marketplace

Codex 和 Claw Hub 各有自己的 plugin 体系,装的也是同一个 skill。(各 agent 的完整步骤。)

给那些没有原生 skill 机制的 agent(Cursor、Cline、Continue、Zed),OMem 的 CLI 能起一个 stdio 的 MCP server(omem mcp),开出同样这六个工具。一条配置就接上了:

Cursor——.cursor/mcp.json(或者 Settings → MCP Servers):

{
  "mcpServers": {
    "omem": { "command": "omem", "args": ["mcp"] }
  }
}

Cline、Continue、Zed——做法一样:command: "omem"、args: ["mcp"],填进那个 agent 的 MCP 配置里。(要是你的 agent 本来就支持 skill,那还是优先用 skill——你能拿到触发判断和往下钻的引导,这些是裸 MCP 那条配置给不了的。)

根本不用什么集成。任何能跑 shell 命令的 agent 都能用 OMem——它本来就是个 CLI:

omem query "what did Alice say about Q3 scope" --format json

skill 和 MCP server,不过是在这条命令外头套了薄薄一层壳。你的 agent 只要会 bash,这会儿就已经能查 OMem 了。

agent 能做什么、不能做什么

skill 和 MCP server 开出的是同样这六个只读工具:

工具	干什么
`query`	在你所有建好索引的工作里做排序搜索
`page_get`	完整的 wiki 页(frontmatter + 正文)
`raw_get_path`	原始源文件的路径(file 类)
`raw_get_parsed_path`	解析后源文的路径(带版本历史)
`wiki_ls`	按类别 / source / 账号 / 日期翻页面
`doctor`	OMem 健康检查

CLI 才是真正的接口——其余都是薄壳

skill(也就是你在 Claude Code 里装的那个 plugin)是一层小小的壳,转头去调 omem query。MCP server 则是个干同样事的薄进程。两者都没重新实现任何东西——一个人在终端里敲,和一个 agent 隔着 plugin 调,跑的是一模一样的命令,拿到一模一样的结果。这是有意这么设计的:agent 这一层年年在变,所以 OMem 让底下那层记忆只认一个稳定的 CLI,而不认任何一个具体的 agent。你随时换 agent,记忆照样在。(设计原则 P5。)

接下来

从一无所有,到一个记得住你工作的 agent——你已经走完这一程了。再往下:

How-to 指南——摄入更多来源、调搜索、定时跑、做备份。
概念——OMem 为什么长成现在这个样子。