Browse / General-purpose / shared-agent-memory
shared-agent-memory
logex-linux
Local-first shared memory for AI agents: MCP and CLI, semantic retrieval, versioned records and traceable sources.
Open logex-linux/shared-agent-memory → On the boundary of the four rules.
Works with any agent
ships AGENTS.md, the cross-tool instruction file.
In its own words
供同一台机器上的多个 AI Agent 共用的本地记忆服务。提供标准 MCP STDIO 和 CLI,用本地 embedding、关键词和代码标识符检索,按当前任务返回相关片段。
Agent 可以搜索全库,不需要预先分配任务可见清单;需要完整记录时,再按 ID 读取。每条记忆保留来源、项目归属和版本。各个 agent harness 的 MCP 配置由使用者接入。
能做什么
- 按需检索:本地 BGE 向量与 FTS5 融合排序,支持中文语义、精确代码和路径检索。
- 跨 Agent 共享:多个 MCP 子进程和 CLI 访问同一 SQLite 数据库,更新立即对后续查询可见。
- 可追溯的编辑:候选与已发布记忆分开;更新保留 ID、递增 revision,冲突不会静默覆盖。
- 明确遗忘:清理正文、索引、依赖记录及受管理导出,撤销清单阻止旧导出恢复已遗忘内容。
- 可维护:索引重建、完整性检查、导出与导入;模型不可用时明确标记关键词降级。
普通查询先在授权范围内做 cosine KNN、Chunk FTS 和标识符索引检索,Focused 在候选预算内读取少量命中 Chunk 进行原文重排,最终只返回入选记录的元数据与命中片段;不会在 Node 中读取或解析全库正文。相邻命中片段合并,按 ID 才展开完整正文。
这是检索式的按需注意:不把整个记忆库放入每次对话。向量相似度表示相关性,是否足以支持结论仍由 Agent 结合来源判断。
安装
需要 Node.js 24.18.0、npm、Python 3 和 Git。路径处理面向 macOS/Linux;不提供 Windows 原生路径支持。当前默认模型为面向中文的 bge-small-zh-v1.5,使用 CPU、FP32、512 维 CLS/L2 编码。
nvm 是选择固定 Node 版本的一个方式;已有相同版本时可直接使用。模型下载是显式安装步骤,固定上游 revision 并核对 SHA-256;服务运行时不下载模型。
默认数据目录是 ~/.local/share/shared-agent-memory/,含数据库、模型、配置和生成的客户端模板。程序可放在 ~/.agents/shared-agent-memory/,让不同 Agent 指向同一个入口。安装器不覆盖已有配置,也不自动修改任何客户端设置。
安装必须显式指定真实工作项目,服务代码目录与工作项目目录分别记录,不默认把服务仓库注册成你的项目。安装结果会输出项目 UUID 和配置绝对路径。新安装的库为空,不含个人记忆、聊天记录或预置的用户偏好。
接入 MCP
安装器生成三套连接配置:config.json 默认只读(可全库搜索)、project.config.json 仅目标项目读写、admin.config.json 全局管理及核验。对应的只读、项目读写、管理员示例可供检查。默认只给日常 Agent 只读配置;写配置由操作者显式选择,服务端按操作与项目范围拒绝越权。
Quoting 17% of the README. Read the rest on GitHub ↗
Read from the repository's git tree on 2026-08-17.