Memryzed

Memryzed

为 AI 编码 Agent 提供持久记忆和会话状态。

Memryzed 是一个本地优先的 MCP 服务，可为任何支持 MCP 的编码 Agent （Claude Code、Kiro、Codex、Cursor、Copilot CLI、Continue 等） 提供跨会话的持久记忆，以及按仓库保存、可恢复的工作状态。

你的 Agent 不再遗忘。你的工作不再从头开始。

看看它如何工作

告诉你的 Agent 一件事，只需一次：

稍后在新的对话中询问——它还记得：

状态

尚未达到 1.0。Memryzed 已实现 v1 规范（docs/specs/v1.md）中的全部功能： 本地记忆存储、混合检索、按仓库划分的会话、基于规则的提取器（以及可选的 本地大模型提取器），以及一个提供九种工具的 MCP 服务。1.0 发布前，API 和磁盘格式仍可能发生变化；兼容性政策请参阅 docs/development/versioning.md，已发布内容请参阅 CHANGELOG.md。

安装

macOS、Linux、WSL：

curl -fsSL https://memryzed.com/install.sh | bash

Windows PowerShell：

irm https://memryzed.com/install.ps1 | iex

Windows 命令提示符：

curl -fsSL https://memryzed.com/install.cmd -o install.cmd && install.cmd

安装后：

memryzed init        # one-time setup
memryzed install     # auto-wire into detected MCP clients
memryzed doctor      # verify everything is working

详细设置说明请参阅 docs/getting-started.md。

Memryzed 能为你提供什么

三层持久上下文，通过一组小巧、稳定的工具接口提供给任何支持 MCP 的 Agent：

• 全局记忆。适用于所有项目和所有设备、与你随行的用户级偏好和事实。
• 项目记忆。限定于仓库的事实，可在同一仓库的多个会话间持久保存：构建命令、约定、责任归属和决策。
• 会话状态。按任务保存的工作状态，让你能从离开的位置准确继续，包括打开的文件、最近的对话和最后执行的命令。

所有数据都保存在你自己的设备上，存储于单个 SQLite 数据库中。默认无需账户， 不收集遥测数据，也不发起网络请求。

工作原理

Memryzed 作为本地 MCP 服务运行，Agent 通过标准输入/输出与其通信。 Agent 会调用九种工具来回忆事实和对话、保存事实、创建会话检查点以及恢复会话。 后台引擎会捕获 Agent 的对话并提出事实；你可以通过 CLI 审核队列批准、编辑或 拒绝这些建议的事实。

完整架构请参阅 docs/architecture.md。

文档

用户文档：

• docs/getting-started.md - 安装和初次使用
• docs/concepts.md - 记忆模型和作用范围
• docs/cli-reference.md - 所有命令
• docs/mcp-reference.md - 所有 MCP 工具
• docs/configuration.md - 配置选项
• docs/troubleshooting.md - 故障排除
• docs/faq.md - 常见问题

面向 Agent 和客户端作者：

• docs/for-agent-authors.md - 如何顺畅集成 Memryzed

面向贡献者和运营人员：

• docs/architecture.md - 系统架构
• docs/data-model.md - 磁盘格式和架构
• docs/specs/v1.md - 完整的 v1 规范
• docs/development/ - 开发、发布和事件响应流程
• docs/roadmap.md - 后续计划

许可证

Apache-2.0。请参阅 LICENSE 和 NOTICE。

贡献

开发环境设置、分支模型和变更提议方式请参阅 CONTRIBUTING.md。参与本项目即表示你同意 CODE_OF_CONDUCT.md。

安全

如需报告漏洞，请遵循 SECURITY.md 中的流程。请勿公开提交安全问题。

作者

Memryzed 由创始人兼首席维护者 Hamza Arjah 创建。完整署名请参阅 AUTHORS，所有贡献者请参阅仓库的贡献者页面。