企业官网建设流程全解析

agentmemory + Codex CLI：从插件市场到6个钩子+17个技能的完整指南

【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory

agentmemory 是为 AI 编码智能体打造的持久化记忆层，而 Codex CLI 是它最完整的原生接入方式之一：一条插件市场命令，即可让 agentmemory 自动注册6 个生命周期钩子 + 17 个技能 + 54 个 MCP 工具，从此告别"每次开新会话都要重新解释项目背景"的烦恼。

📌 为什么 Codex 需要 agentmemory 记忆插件

用 Codex CLI 写代码时，你大概率遇到过这些场景：

• 上周调过的 bug，本周又让我从头排查一遍
• 项目约定（命名规范、部署流程）每次都要重新交代
• 长会话上下文被压缩后，关键决策细节丢失

agentmemory 的思路是：让智能体自动"观察"你的工作（工具调用、决策、报错），通过 LLM 压缩成结构化记忆，再在下一个会话中自动召回注入上下文。官方基准数据显示召回率（R@5）达 95.2%，同时节省约 92% 的 token 开销。

🚀 最快接入方式：两条命令走插件市场

第 1 步：启动记忆服务

npx @agentmemory/agentmemory

首次运行是交互式向导：勾选要接入的智能体、选择 LLM 提供方（可以无 key 运行），服务默认跑在:3111端口。

第 2 步：在 Codex CLI 中安装插件

codex plugin marketplace add rohitg00/agentmemory codex plugin add agentmemory@agentmemory

这两条命令来自 Codex 官方插件平台机制，agentmemory 会一并完成：

💡 插件的.mcp.json会自动注册 MCP 服务器，不需要任何额外配置。装完后用curl http://localhost:3111/agentmemory/health验证服务是否正常。

🪝 6 个生命周期钩子逐一拆解

插件内置的钩子清单见 plugin/hooks/hooks.codex.json，覆盖智能体工作流的完整生命周期：

这套"捕获 → 压缩 → 注入"的闭环正是 agentmemory 的核心设计（详见 DESIGN.md）。每个钩子背后的可执行脚本都在 plugin/scripts/ 目录，比如pre-compact.mjs负责压缩前的记忆抢救、session-start.mjs负责开场上下文注入。

🧠 17 个技能：让 Codex 真正"会用"记忆

插件在 plugin/skills/ 下打包了 17 个原生技能，安装后 Codex 会自动知道什么时候该调记忆、怎么调。按用途分为两组：

日常记忆技能（你高频用到的）

• recall—— 混合检索（BM25 + 向量 + 图搜索）过往会话的结论，如 plugin/skills/recall/SKILL.md
• remember/forget—— 手动记住一条经验，或清除某段记忆
• handoff—— 会话交接：把当前进展打包成可续接的上下文
• lesson—— 把踩坑经验沉淀为可复用的"教训"
• recap/session-history—— 回顾某次会话或项目历史
• commit-context/commit-history—— 把记忆与提交记录关联
• memory-discipline—— 约束智能体的记忆使用规范，防止乱记

agentmemory 运维技能（了解系统本身）

• agentmemory-architecture/agentmemory-config/agentmemory-hooks/agentmemory-mcp-tools/agentmemory-rest-api/agentmemory-agents—— 六份技能手册，覆盖架构、配置、钩子、MCP 工具与 REST API
• write-agentmemory-skill—— 引导你编写新的记忆技能
• agentmemory-hooks附带的排障指南见 plugin/skills/_shared/TROUBLESHOOTING.md

想自己写技能？跟着write-agentmemory-skill的技能文档走一遍即可。

📡 进阶：Codex Desktop 用户的 --with-hooks 选项

一个需要注意的细节：Codex Desktop 目前不会分发插件作用域的hooks.json（上游 issue 尚未修复）。agentmemory 提供了干净的 workaround：

agentmemory connect codex --with-hooks

该命令由 src/cli/connect/codex.ts 实现，合并逻辑在 src/cli/connect/codex-hooks.ts：它把 6 个钩子以绝对路径镜像写入全局~/.codex/hooks.json，且幂等——重复执行会先清理旧条目再写入，不会污染你已有的钩子配置。

两个使用提醒：

1. Codex 只运行"受信任"的钩子。安装后首次启动codexTUI 时，选择"Trust all and continue"授权一次
2. 升级 agentmemory 后重跑一次--with-hooks刷新路径，并重新授权

✅ 验证清单：三步确认一切就绪

想补装更多技能给智能体，再跑一次npx skills add rohitg00/agentmemory -y即可。至此，你的 Codex CLI 已经拥有了跨会话的长期记忆——不再重复解释，不再重复踩坑。

更多配置细节可参考 docs/ 目录与 packages/mcp/README.md。

【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory