{"type": "text"}# agents-memory
面向 AI 编码助手的本地 Markdown 记忆与跨代理上下文引擎。
一个持久化身份，跨 Claude Code、Cursor、Antigravity 和 Zed 共享。
.agents/memory？名称 agents-memory 直接来源于其通用存储标准：.agents/memory。
全局： ~/.agents/memory/ 存储你的持久化身份、技术栈默认配置、持久概念和项目索引。
仓库： <repo>/.agents/memory/ 存储仓库特定的事实、架构 ADR 和暂存收件箱。
当 AI 供应商将配置分散到专有存储中时，.agents/ 为所有代理配置和共享智能提供了一个单一、开放、与供应商无关的文件系统中心。
agents-memory 通过纯 Markdown 优先架构实现这一点：
本地与离线： 你的身份和仓库记忆保存在纯文本文件中（~/.agents/memory/ 和 <repo>/.agents/memory/）。
人类可读且对 Git 友好： 使用任何文本编辑器编辑，使用 git 进行差异比较，随时提交。
通用 MCP 服务器： 向所有现代代理公开内存工具（search_memory、add_memory、get_project_memories、distill_batch）。
自主摄取与提炼： 从会话日志（OpenAI、Claude、Cursor、Copilot、Antigravity、Pi）中提取持久规则和架构决策。
Related MCP server: agent-julia
┌─────────────────────────────────────────────────────────────┐
│ SESSION INGEST │
│ OpenAI Exports · Claude JSONL · Cursor · Antigravity · Pi │
└──────────────────────────────┬──────────────────────────────┘
│ ingest catalog / extract
▼
┌─────────────────────────────────────────────────────────────┐
│ STAGING INBOX │
│ Raw captured bullets & noise-filtered facts │
└──────────────────────────────┬──────────────────────────────┘
│ distill_batch / skill
▼
┌─────────────────────────────────────────────────────────────┐
│ LOCAL MEMORY STORE │
│ ~/.agents/memory/USER.md ~/.agents/memory/PROJECTS.md │
│ ~/.agents/memory/concepts/ <repo>/.agents/memory/ │
└──────────────┬───────────────────────────────┬──────────────┘
│ │
▼ ▼
┌─────────────────────────────┐ ┌─────────────────────────────┐
│ IDE INJECTION │ │ MCP SERVER & CLERK │
│ Cursor Rules · Zed Context │ │ search_memory · add_memory │
│ Antigravity AGENTS.md │ │ Universal Tool Integration │
└─────────────────────────────┘ └─────────────────────────────┘pip install agents-memory && agents-memory sync --init搭建 ~/.agents/memory/ 目录结构，自动将 MCP 配置接入已安装的 IDE，并注册助手技能。
[!TIP] 🤖 代理驱动设置（零摩擦）：
只需告诉你的编码代理：“为我安装并设置 agents-memory。”
代理将安装该包，询问一次你的技术栈偏好，填写你的USER.md配置文件，并自主注册你的仓库。
命令 | 用途 |
| 更新规范的 |
| 首次搭建、示例创建和主机发现 |
| 跨工作区根目录发现未注册的本地仓库 |
| 注册新仓库 |
| 索引所有受支持提供商的本地聊天记录 |
| 运行启发式过滤器，将持久事实提取到暂存区 |
| 确保没有私有状态泄漏到工作仓库中 |
Claude Code： 通过符号链接 / 规范 AGENTS.md 和 MCP 服务器绑定。
Google Antigravity： 通过 .gemini/config 规则和 agents-memory MCP 集成。
Cursor： 自动注入规则并配置 .cursor/mcp.json。
Zed： 配置 context_servers 并镜像助手技能。
VS Code / Copilot： 从本地状态数据库摄取会话历史。
还兼容： Windsurf、Cline、Roo-Code、Aider、Continue.dev、OpenAI ChatGPT、Pi、Goose 以及任何符合 MCP 标准的 AI 助手。
正式的、与实现无关的布局规范位于 abi/：
abi/WHY.md — 架构决策及为什么 Markdown 优于 RAG。
abi/LAYOUT.md — 目录分类和路径约定。
abi/KINDS.md — 类型化记忆分类（concepts、facts、decisions）。
abi/MCP.md — 工具定义和请求/响应规范。
abi/INGEST.md — 目录、提取和提炼流水线。
abi/INJECTION.md — 主机规则注入机制。
运行全面的测试套件和提炼基准测试：
python tests/run_all_tests.pyMIT 许可证。详情请参阅 LICENSE。
This server cannot be deployed
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Shared AI memory. ChatGPT, Claude, Cursor and any MCP app read and write the same memory.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
