CogmemAi 是一个可移植的持久化记忆层,旨在为任意 AI 系统提供跨会话、设备、用户和团队的持久回忆能力。它不仅能记住重要信息,还能在动作发生前执行用户设定的规则,并在工作完成后对照用户意图进行审查。官方将其定位为面向助手、智能体、机器人、车辆和代码的安全记忆系统。
主要能力
- 持久记忆:跨会话、设备、用户和团队保留知识,即使 AI 忘记保存,也能自主捕获知识。
- 规则执行(Guard):通过 PreToolUse 钩子在 shell 命令运行前进行判断,内置规则覆盖危险操作,如从管道重写整个 crontab、对生产数据库执行破坏性 SQL、递归删除、强制推送到共享分支、将下载内容管道到 shell、按名称杀死共享服务器工作进程等。规则记忆(save_rule)可转化为可执行模式,支持 GUARD 行精确匹配或关闭。
- 意图审查(Intent):每个项目可有一份纯英文意图文档,通过 set_intent 写入、get_intent 读取。不变量句子会被编译为可执行模式,在命令运行前拒绝违规操作;每轮结束时对照意图审查变更,并以非技术人员可读的英文报告。
- 工作审查(Review):通过 review_work 工具或 REST 端点,将描述、输出、消息或记录与意图文档对照,返回摘要、覆盖、未覆盖、违规和覆盖率。
- 自主记忆:v3.15 起在基础设施层面捕获编码会话,会话结束时提炼为结构化记忆,无需 AI 主动保存。
- 主动回忆:preflight 工具在 AI 建议任何行动前自动检查记忆。
- 字符预算:recall_memories 支持 max_chars 参数,控制返回内容长度,避免长记忆占用过多上下文。
- 迁移工具:migrate 命令可评估迁移到 AWS、Azure 或 GCP,生成清单、迁移范围文档和 MIGRATION.md,并安装对应云规则包。
- 规则包:rules install devsecops 可安装 40 条现成规则,覆盖密钥、基础设施即代码、最小权限、网络暴露、CI/CD 门禁、变更控制、容器与 Kubernetes、数据处理、日志与事件响应等。
- 认证:托管端点支持 OAuth 2.1,也继续支持 API 密钥。
使用方式
- 通过 npx cogmemai-mcp 运行 MCP 服务器,兼容 Claude Code、Cursor、Windsurf、Cline、Continue 及任何 MCP 兼容工具。
- 托管端点:https://hifriendbot.com/mcp/,支持 OAuth 2.1 登录。
- 常用命令示例:npx cogmemai-mcp migrate assess --target aws;npx cogmemai-mcp rules install devsecops;cogmemai-mcp migrate gate "<phase>";cogmemai-mcp migrate inventory。
- 环境变量:COGMEMAI_RECALL_MAX_CHARS 可设置默认回忆字符预算;COGMEMAI_INTENT_VERBOSE=1 可显示每轮审查摘要。
- 工具:recall_memories、save_memory、save_rule、guard_check、review_work、set_intent、get_intent、preflight 等。
- SDK 与 REST:提供 guardCheck / reviewWork 等 SDK 调用,以及 POST /cogmemai/guard-check 和 POST /cogmemai/intent-check 端点。
适用场景
- 编码助手:在 Claude Code、Cursor 等工具中保持项目知识、执行安全规则、审查代码变更。
- 智能体与机器人:为自主系统提供持久记忆和规则执行。
- 团队协作:跨用户、设备共享记忆和规则。
- 云迁移:评估和规划迁移,安装云安全规则包。
- 非代码工作:通过 guard_check 和 review_work 审查消息、购买、变更等任意动作。
限制
- 部分高级功能(如 judged check)仅在付费层级提供,免费层级仍可使用强制不变量和确定性审查。
- 审查功能在 v3.29.0 之前需要 git 仓库,之后改为读取会话编辑事件。
- 迁移评估通过 MSGR 网关运行,受账户每日限额限制。
- 官方未提供具体价格、平台支持细节或完整使用步骤,部分信息暂未提供。