agents-memory
{"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配置文件,并自主注册你的仓库。
CLI 参考
命令 | 用途 |
| 更新规范的 |
| 首次搭建、示例创建和主机发现 |
| 跨工作区根目录发现未注册的本地仓库 |
| 注册新仓库 |
| 索引所有受支持提供商的本地聊天记录 |
| 运行启发式过滤器,将持久事实提取到暂存区 |
| 确保没有私有状态泄漏到工作仓库中 |
支持的生态系统
Claude Code: 通过符号链接 / 规范
AGENTS.md和 MCP 服务器绑定。Google Antigravity: 通过
.gemini/config规则和agents-memoryMCP 集成。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/:
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.py许可证
MIT 许可证。详情请参阅 LICENSE。
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityBmaintenancePersistent memory MCP server for Claude Code, Cursor, and GitHub Copilot. Semantic search, Git sync, project-based, Persistent memory MCP server for Claude Code, Cursor, and GitHub Copilot. Semantic search, Git sync, project-based organization, and team collaboration via Model Context Protocol.672432MIT
- Alicense-qualityAmaintenanceLocal-first MCP server providing persistent markdown memory with persona engine and fast search, designed to unify AI assistant memory across Claude Code, Cowork, and Dispatch.55MIT
- Flicense-qualityFmaintenanceA local-first, team-ready MCP server providing durable memory for LLM-based coding workflows with multiple storage backends and fast search.4
- AlicenseBqualityBmaintenanceLocal-first memory server for AI coding agents that stores work sessions, tasks, and durable memories in Markdown files, exposed through MCP tools for session management and memory retrieval.10151MIT
Related MCP Connectors
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lolaplex/agents-memory'
If you have feedback or need assistance with the MCP directory API, please join our Discord server