memcell
用于人工智能代理的持久、自适应记忆引擎。
阻止代理在不同的会话中重复同样的错误。
# Install globally
npm install -g memcell
# In any project:
memcell connect
在任何项目中运行它。 memcell connect 自动:
- 一键审批：打开浏览器审批（不需要预先帐户；登录时无缝地保留客人的记忆）。
- 检测代理:电线 Claude Code, Cursor, Copilot CLI, Gemini CLI, OpenAI Codex, OpenCode, Cline, Windsurf，以及更多非破坏性生命周期钩子和本地工作室MCP服务器(
memcell mcp）. - 获得证书：将范围代理密钥直接存储在您的操作系统密钥环（Keychain / Secret Service / Credential Manager）中。
- 创建
.memcell：在你的repo根目录中添加一个干净的、git安全的项目描述符。
随时验证:
memcell status
为什么MemCell ?
每次你与AI代理开始一个新的会话时，它都会以完全失忆开始。它会陷入同样的陷阱，重复过时的假设，重现你昨天已经解决的问题。
静态指令文件和单片系统提示不能解决这个问题：
- 上下文膨胀：堆叠数十个指令在每回合都浪费令牌，并稀释模型的注意力。
- 零适应性过时的指令即使在需求改变时也会继续生效。
- 人工开销你仍然是唯一的反馈回路，不断手工编辑降价文件。
MemCell为您的代理提供闭环记忆：
- Pre-Action回忆 在采取行动之前，代理会收到与当前任务相关的经过验证的记忆。
- 执行与反馈 -当行动成功或失败时，将报告实际结果。
- 获得信心 -工作记忆获得信心；失败的记忆会衰退。无需人工及时维护。
它是如何工作的
MemCell对两个轻量级层，使代理保持对齐，而不会妨碍你的方式：
- 确定性挂钩（零接触）：在会话开始、提示提交和回合结束时自动触发。在操作开始之前检查相关内存、活动会话线程和指令，而不依赖于模型记住调用工具。 钩子在50毫秒内打开失败，所以离线或慢速网络永远不会阻塞编辑器。
- MCP工具桥架(
memcell mcp）：提供互动工具(recall，remember，report)，当代理人需要搜索记忆或记录发现时。
日常的使用
一旦连接，代理会自动召回并报告内存。你也可以直接从你的终端与内存交互：
1. 执行前召回已验证的上下文
memcell recall "how do we handle multi-tenant database sessions?"
2. 记录一个决定或指令
# Record a workspace instruction
memcell remember "Always use pnpm for package operations; never invoke npm directly" --type instruction
# Record an architectural decision
memcell remember "Use Next.js for both backend and frontend with shadcn for UI" --type decision
# Bind an instruction to a specific lifecycle trigger
memcell remember "Check database migrations for column locks before altering tables" --type instruction --at change
3. 报告发生的事情
当被告知所发生的事情时，记忆会变得清晰。当方法成功或失败时，报告结果：
memcell report mem_019a4b2c worked --note "CI suite passed cleanly"
memcell report mem_019a4b2c failed --note "broke Next.js 15 async cookies"
4. 摄取规格和现有指引
# Index workspace docs and project manifests for grounded RAG and graph extraction
memcell ingest
# Scan and import existing guideline files (CLAUDE.md, etc.)
memcell import
5. 检查属性令牌节省
memcell stats
显示跟踪的记忆，避免的错误，从防止的错误循环中保存的估计标记，以及30天的活动火花线。
支持的代理和ide
| 代理/线束 | 集成 | 它是如何运行的 |
|---|---|---|
| 克劳德代码 | 钩子+ MCP +插件 | 自动生命周期挂钩或市场插件(/plugin marketplace add memcell-ai/mcp） |
| 光标 | 钩子+ MCP桥 | 本地生命周期挂钩 .cursor/hooks.json 还有演播室桥 .cursor/mcp.json |
| 双子座CLI | 钩子+ MCP | 会话和提示钩子通过本地CLI控制 |
| GitHub Copilot CLI | 生命周期的钩子 | 预命令验证挂钩 |
| OpenAI Codex / OpenCode | 钩子+ MCP | 工作区描述符挂钩和工作室工具 |
| 克莱恩和风帆冲浪 | MCP桥 | 本机编辑器MCP客户端配置 |
| 工厂机器人，德文，基罗，鹅 | 钩子+ MCP | 工作区适配器和工具线束 |
命令小抄
| 命令 | 描述 |
|---|---|
memcell start [--daemon] | 运行本地MemCell服务器与嵌入式PGlite矢量引擎 |
memcell stop | 停止本地后台服务器守护进程 |
memcell connect | 将此目录连接到MemCell，安装hooks，并配置MCP |
memcell status | 检查身份验证状态、活动工作区和连接运行状况 |
memcell stats | 显示内存遵循，避免错误，并节省标记 |
memcell recall <intent> | 查询已验证的内存、线程和文档 |
memcell remember <text> | 将指示、决定、事实或偏好归档 |
memcell report <id> <outcome> | 报告 worked， failed,或 avoided 更新信心 |
memcell thread | 列出、检查、恢复或完成工作会话线程 |
memcell ingest [paths...] | 索引工作区文档和清单到接地RAG和内存图 |
memcell document | 列出、搜索或删除已索引的工作空间文档 |
memcell import [files...] | 导入现有指引文件(CLAUDE.md等)。 |
memcell export | 将工作空间记忆体导出为可携式文件(--format json|md） |
memcell orgs | 列出或切换活动组织(memcell orgs switch <slug>） |
memcell workspaces | 列出或切换活动工作区(memcell workspaces use <slug>） |
memcell hook remove | 干净地从该目录中删除所有MemCell挂钩 |
memcell reset | 清除这台计算机上所有缓存的凭据、密钥和令牌 |
运行 memcell --help 或 memcell <command> --help 有关旗帜的详细信息。
干净卸载
从存储库中删除MemCell钩子而不触及代码：
memcell hook remove
rm .memcell
要从本地计算机中删除所有存储的密钥和凭据：
memcell reset
链接
Apache License 2.0·©2026 Memcell, Inc